DIGITAL RESEARCH ™ 


CP/M®-86 


System Guide 


GENITH eye |data HEATH | 


OEP 
systems 


CP/M-86° 
System Guide 


Covyright © 1981 


Digital. Research 
P.O. Box 579 
801 Lighthouse Avenue 
Pacific Grove, CA 93950 
(408) 649-3896 
TWX 910 360 5001 


All Rights Reserved 


RESTRICTED RIGHTS LEGEND 
This ciecnil software and documentation are provided with RESTRICTED RIGHTS. 
Use, duplication or disclosure by the Government is subject to restrictions as set forth 


in the governing Rights in Technical Data and Computer Software clause — subdivision 
(b)(3)(B) of DAR 7-104.9(a) (May 1981) or subdivision (b)(3)(ii) of DOD FAR Supp 
252.227-7013 (May 1981). Contractor/Manufacturer is Zenith Data Systems Corpora- 
tion, of Hilltop Road, St. Joseph, MI 49085. 


Foreword 


The CP/M-86 System Guide oresents the svstem programming 
aspects of CP/M-86® , 4a single-user operating system for the Intel. 
8086 and 8088 16-bit microprocessors. The discussion assumes the 
reader is familiar with CP/M the Nigital Research 8-bit operating 
system. To clarify sovecific differences with CP/M-86, this document 
refers to the 8-bit version of CP/M as cp/M-80TM, Elements common 
to both systems are simply called CP/M features. 


CP/M-80 and CP/M-86 are equivalent at the user interface level 
and thus the Digital Research documents: 


@® An Introduction to CP/M Features and Facilittes 
@® ED: A Context Fditor for the CP/M Disk System 
@® cP/M 2 Yser’s Guide 


are shipped with the CP/M-86 package. Also included is the CP/M-86 
Programmer*s Guide, which describes ASM-86°™ and pnT-86~™", Digital 
Research’s 8086 assembler and interactive debugger. 


This Svstem Guide presents an overview of the CP/M-86 
programming interface conventions. [Tt also describes orocedures for 
adavting CP/M-86 to a custom hardware enviornment. This information 
parallels that presented in the CP/M 2? Interface Guide and the CP/M 
2 Alteration Guide. | | 


Section 1 gives an overview of cP/M-86 and summarizes its 
differences with CP/M-80. Section 2 describes the general execution 
environment while Section 3 tells how to generate command files. 
Sections 4 and 5 respectively define the programming interfaces to 
the Basic Disk Operating Svstem and the Basic Tnout/Output System. 
Section 6 discusses alteration of the BIOS to suoport custom disk 
configurations, and Section 7 describes the loading operation and 
the organization of the CP/M-86 svstem file. 
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Section 1 
CP/M-86 System Overview 


1.1 CP/M-86 General Characteristics 


CP/M-86 contains all facilities of CP/M-80 with additional 
features to account for increased processor address space of up toa 
megabyte (1,048,576) of main memory. Further, CP/M-86 maintains 
file compatibility with all previous versions of CP/M. The file 
structure of version 2 of CP/M is used, allowing aS many as sixteen 
drives with up to eight megabytes on each drive. Thus, CP/M-80 and 
CP/M-86 systems may exchange files without modifying the file 
format. 


CP/M-86 resides in the file CPM.SYS, which is loaded into 
memory by a cold start loader during system initialization. The 
cold start loader resides on the first two tracks of the system 
disk. CPM.SYS contains three program modules: the Console Command 
Processor (CCP), the Basic Disk Operating System (BDOS), and the 
user-configurable Basic I/O System (BIOS). The CCP and BDOS 
portions occupy approximately 10K bytes, while the size of the BIOS 
varies with the implementation. The operating system executes in 
any portion of memory above the reserved interrupt locations, while 
the remainder of the address space is partitioned into as many as 
eight non-contiguous regions, as defined in a BIOS table. Unlike 
CP/M-80, the CCP area cannot be used as a data area subsequent to 
transient program load; all CP/M-86 modules remain in memory at all 
times, and are not reloaded at a warm start. 


Similar to CP/M-80, CP/M-86 loads and executes memory image 
files from disk. Memory image files are preceded by a “header 
record," defined in this document, which provides information 
required for proper program loading and execution. Memory. image 
files under CP/M-86 are identified by a "CMD" file type. 


Unlike CP/M-80, CP/M-86 does not use absolute locations for 
system entry or default variables. The BDOS entry takes place 
through a reserved software interrupt, while entry to the BIOS is 
provided by a new BDOS call. Two var iables maintained in low memory 
under CP/M-80, the default disk number and I/O Byte, are placed in 
the CCP and BIOS, respectively. Dependence upon absolute addresses 
is minimized in CP/M-86 by maintaining initial "base page" values, 
such as the default FCB and default command buffer, in the transient 
program data area. 


Utility programs such as ED, PIP, STAT and SUBMIT operate in 
the same manner under CP/M-86 and CP/M-80. In its operation, NDT-86 
resembles DDT supplied with CP/M-80. It allows interactive 
debugging of 8086 and 8088 machine code. Similarly, ASM-86 allows 
assembly language programming and development for the 8086 and 8088 
using Intel-like mnemonics. 
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The GENCMD (Generate CMD) utility replaces the LOAD program of 
CP/M-80, and converts the hex files voroduced by ASM-86 or Intel 
utilities into memory image format suitable for execution under 
CP/M-86. Further, the LDCOPY (Loader Copy) program replaces SYSGEN, 
and is used to copy the cold start loader from a system disk for 
replication. In addition, a variation of GENCMD, called ULMCMD, 
converts output from the Intel LOC86 utility into CMD format. 
Finally, GENDEF (Generate DISKDEF) is brovided as an aid in 
producing custom disk parameter tables. ASM-86, GENCMD, LMCMD, and 
GENDEF are also supplied in "COM" file format for cross-development 
under CP/M-80. 


Several terms used throughout this manual are defined in Table 
1-1 below: 


Table 1-1. CP/M-86 Terms 


Nibble 

Byte 

Word 

Nouble Word 
Paragraph 


‘' Paragraph Boundary 


Segment 


Segment Register 


Offset 


Group 


Address 


4-bit half-byte 
8-bit value 

16-bit value 

32-bit value 

16 contiguous bytes 


An address divisible evenly 
by 16 (low order nibble 0) 


Up to 64K contiguous bytes 


One of CS, DS, ES, or SS 
16-bit displacement from a 
segment register 


A segment-register-relative 
relocatable program unit 


The effective memory address 
derived from the composition 
of a segment register value 
with an offset value 


A group consists of segments that are loaded into memory as a single 
unit. Since a group may consist of more than 64K bytes, it is the 
responsibility of the application program to manage segment 
registers when code or data beyond the first 64K segment is 
accessed. 
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CP/M-86 System Guide 1.1 CP/M-86 General Characteristics 


CP/M-86 supvorts eight program groups: the code, data, stack 
and extra groups as well as four auxiliary groups. When a code, 
data, stack or extra group 1s loaded, CP/M-86 sets the respective 
segment register (CS, DS, SS or ES) to the base of the group. CP/M- 
86 can also load four auxiliary groups. A transient program manages 
the location of the auxiliary groups using values stored by CP/M-86 
in the user’s base page. 


1.2 CP/M-80 and CP/M-86 Differences 


The structure of CP/M-86 is as close to CPp/M-80 as possible in 
order to provide a familiar programming environment which allows 
application programs to be transported to the 8086 and 8088 
processors with minimum effort. This section points out the 
specific differences between CP/M-80 and CP/M-86 in order to reduce 
your time in scanning this manual if you are already familiar with 
CP/M-80. The terms and concepts presented in this section are 
explained in detail throughout this manual, so you will need to 
refer to the Table of Contents to find relevant sections which 
provide specific definitions and information. 


Due to the nature of the 8086 processor, the fundamental 
difference between CP/M-80 and CP/M-86 is found in the management of 
the various relocatable groups. Although CP/M-80 references 
absolute memory Locations by necessity, cp/M-86 takes advantage of 
the static relocation inherent in the 8086 orocessor. The operating 
system itself is usually loaded directly above the interrupt 
locations, at location 0400H, and relocatable transient programs 
load in the best fit memory region. However, you can load CP/M-86 
into any portion of memory without changing the operating system 
(thus, there is no MOVCPM utility with CP/M-86), and transient 
programs will load and run in any non-reserved region. 


Three general memory models are presented below, but if you are 
converting 8080 programs to CP/M-86, you can use either the 8080 
Model or Small Model and leave the Compact Model for Later when your 
addressing needs increase. You’1l] use GENCMD, described in Section 
3.2, to produce an executable program file from a hex file. GENCMD 


parameters allow you to specify which memory model your program 
requires. 


CP/M-86 itself is constructed as an 8080 Model. This means 
that all the segment registers are placed at the base of CP/M-86, 
and your customized BIOS is identical, in most respects, to that of 
CP/M-80 (with changes in instruction mnemonics, of course). In 
fact, the only additions are found in the SETDMAB, GETSEGB, SETIOB, 
and GETIOB entry points in the BIOS. Your warm start subroutine is 
simpler since you are not required to reload the CCP and BDOS under 
CP/M-86. One other point: if you implement the IOBYTE facility, 
you’ll have to define the variable in your BIOS. Taking these 
changes into account, you need only perform a simple translation of 
your CP/M-80 BIOS into 8086 code in order to implement your 8086 
BIOS. 
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If you“ve implemented CP/M-80 Version 2, you already have disk 
definition tables which will operate properly with CP/M-86. You may 
wish to attach different disk drives, or experiment with sector skew 
factors to increase performance. If so, you can use the new GENDEF 
utility which performs the same function as the DISKDEF macro used © 
by MAC under CP/M-80. You’ll find, however, that GENDEF provides 
you with more information and checks error end tt rons better than 
the DISKDEF macro. 


Although generating a CP/M-86 system is generally easier than 
generating a CP/M-80 system, complications arise if you are using 
single-density floppy disks. CP/M-86 is too large to fit in the 
two-track system area of a single-density disk, so the bootstrap 
Operation must perform two steps to load CP/M-86: first the 
bootstrap must load the cold start loader, then the cold start 
loader loads CP/M-86 from a system file. The cold start loader 
includes a LDBIOS which is identical to your CP/M-86 BIOS with the 
exception of the INIT entry point. You can simplify the LDBIOS if 
you wish because the loader need not write to the disk. If you have 
a double-density disk or reserve enough tracks on a single-density 
disk, you can load CP/M-86 without a two-step boot. 


To make a BDOS system call, use the reserved software interrupt 
#244. The jump to the BDOS at location 0005 found in CP/M-80 is not 
present in CP/M-86. However, the address field at offset 0006 is 
present so that programs which "size" available memory using this 
word value will operate without change. CP/M-80 BDOS functions use 
certain 8080 registers for entry parameters and returned values. 
CP/M-86 BDOS functions use a table of corresponding 8086 registers. 
For example, the 8086 registers CH and CL correspond to the 8080 
registers B and C. Look through the list of BDOS function numbers 
in Table 4-2. and you’ll find that functions 0, 27, and 31 have 
changed slightly. Several new functions have been added, but they. 
do not affect existing programs. 


One major philosophical difference is that in CP/M-80, all] 
addresses sent to the BDOS are simply 16-bit values in the range 
OOOOH to OFFFFH. In CP/M-86, however, the addresses are really just 
16-bit offsets from the DS (Data Seqment) register which is set to 
the base of your data area. If you translate an existing CP/M-80 
program to the CP/M-86 environment, your data segment will be less 
than 64K bytes. In this case, the DS register need not be changed 
following initial load, and thus all CP/M-80 addresses become simple 
DS-relative offsets in CP/M-86. 


Under CP/M-80, programs terminate in one of three ways: by 
returning directly to the CCP, by calling BDOS function 0, or by 
transferring control to absolute location 0000H. CP/M-86, however, 
Supports only the first two methods of program termination. This 
has the side effect of not providing the automatic disk system reset 
following the jump to 0000H which, instead, is accomplished by 
entering a CONTROL-C at the CCP level. 
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You’11 find many new facilities in CP/M-86 that will simplify 
your programming and expand your application programming capability. 
But, we’ve designed CP/M-86 to make it easy to get Started: in 
short, if you are converting from CP/M-80 to CP/M-86, there will be 
no major changes beyond the translation to 8086 machine code. 
Further, programs you design for CP/M-86 are upward compatible with 
MP/M-86, our multitasking operating system, as well as CP/NET-86 
which provides a distributed operating system in a network 
environment. 
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Section 2 ) 
Command Setup and Execution Under CP/M-86 


This section discusses the operation of the Console Command 
Processor (CCP), the format of transient programs, CP/M-86 memory 
models, and memory image formats. 


2.1 CCP Built-in and Transient Commands 


The operation of the CP/M-86 CCP is similar to that of CP/M-80. 
Upon initial cold start, the CP/M sign-on message is printed, drive 
A is automatically logged in, and the standard prompt is issued at 
the console. CP/M-86 then waits for input command lines from the 
console, which may include one of the built-in commands 


DIR ERA REN TYPE USER 


(note that SAVE is not supported under CP/M-86 since the equivalent 
function is performed by DDT-86). 


Alternatively, the command line may begin with the name of a 
transient program with the assumed file type "CMD" denoting a 
"command file." The CMD file type differentiates transient command 
files used under CP/M-86 from COM files which operate under CP/M-80. 


The CCP allows multiple programs to reside in memory, providing 
facilities for background tasks. A transient program such as a 
debugger may load additional programs for execution under its own 
control. Thus, for example, a background printer spooler could 
first be loaded, followed by an execution of DDT-86. DDT-86 may, in 
turn, load a test program for a debugging session and transfer 
control to the test program between breakpoints. CP/M-86 keeps 
account of the order in which programs are loaded and, upon 
encountering a CONTROL-C, discontinues execution of the most recent 
program activated at the CCP level. A CONTROL-C at the DDNT-86 
command level aborts DDT-86 and its test program. A second CONTROL- 
C at the CCP level aborts the background printer spooler. A third 
CONTROL-C resets the disk system. Note that program abort due to 
CONTROL-C does not reset the disk system, as is the case in CP/M-80. 
A disk reset does not occur unless the CONTROL-C occurs at the CCP 
command input level with no programs residing in memory. 


When CP/M-86 receives a request to load a transient program 
from the CCP or another transient program, it checks the program’s 
memory requirements. If sufficient memory is available, CP/M-86 
assigns the required amount of memory to the program and loads the 
program. Once loaded, the program can request additional memory 
from the BDOS for buffer space. When the program is terminated, 
CP/M-86 frees both the program memory area and any additional buffer 
space. 
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2.2 Transient Program Execution Models 
The initial values of the segment registers are determined by 
one of three "memory models" used by the transient program, and 


described in the CMD file header. The three memory models are 
Summarized in Table 2-1 below. 


Table 2-1. CP/M-86 Memory Models 


8080 Model Code and Data Groups Overlap 


Smal]. Model Independent Code and Data Groups 


Compact Model Three or More Independent Groups 


The 8080 Model supports programs which are directly translated 
from CP/M-80 when code and data areas are intermixed. The 8080 
model consists of one group which contains all the code, data, and 
Stack areas. Segment registers are initialized to the starting 
address of the region containing this group. The segment registers 
can, however, be managed by the application program during execution 
so that multiple segments within the code group can be addressed. 


The Small Model is similar to that defined by Intel, where the 
program consists of an independent code group and a data group. The 
Small Model is suitable for use by programs taken from CP/M-80 where 
Gode and data is easily separated. Note again that the code and 
data groups often consist of, but are not restricted to, single 64K 
byte segments. 


The Compact Model occurs when any of the extra, stack, or 
auxiliary groups are present in program. Each group mav consist of 
One or more segments, but if any group exceeds one segment in size, 
or if auxiliary groups are present, then the application program 
must manage its own segment registers during execution in order to 
address all code and data areas. 


The three models differ primarily in the manner in which 
segment registers are initialized upon transient program loading. 
The operating system program load function determines the memory 
model used by a transient program by examining the program group 
usage, as described in the following sections. 


All Information Presented Here is Proprietary to Digital Research 


8 


CP/M-86 ‘System Guide 2.3 The 8080 Memory Model 


2.3 The 8080 Memory Model 


The 8080 Model is assumed when the transient program contains 
only a code group. In this case, the CS, DS, and ES registers are 
initialized to the beginning of the code group, while the SS and SP 
registers remain set to a 96-byte stack area in the CCP. The 
Instruction Pointer Register (IP) is set to 100H, similar to CP/M- 
80, thus allowing base page values at the beginning of the code 
group. Following program load, the 8080 Model appears as shown in 
Figure 2-1, where low addresses are shown. at the top of the diagram: 


SS: 
CCP 
SS + SP: CCP Stack 
CS DS ES: 
DS+0000H: base 


page 


CS+0100H: IP = 0100H 
code 


data 


data 


Figure 2-1. CP/M-86 8080 Memory Model 


The intermixed code and data regions are indistinguishable. The 
"base page" values, described below, are identical to CP/M-80, 
allowing simple translation from 8080, 8085, or 280 code into the 
8086 and 8088 environment. The following ASM-86 example shows how 
to code an 8080 model transient program. | 


eseg 
org 100h 
: (code) 
endcs equ $ 
dseg 
org offset endcs 
. (data) 
end 
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2.4 The Small Memory ‘iodel 


The Small Model is assumed when the transient program contains 
both a code and data group. (In ASM-86, all code is generated 
following a CSEG directive, while data is defined following a DSEG 
directive with the origin of the data segment independent of the 
code segment.) In this model, CS is set to the beginning of the 
code group, the DS and ES are set to the start of the data group, 
and the SS and SP registers remain in the CCP’s stack area as shown 
in Figure 2-2. 


SS: 
CCP 


SS + SP: CCP Stack 


CS: IP = 00O00H 
code 


DS ES: 


DS+0100H: 


Figure 2-2. CP/m—86 Small Memory Model 


The machine code begins at CS+0000H, the "base page" values begin at 
DS+0000H, and the data area starts at DS+O100H. The following ASM- 
86 example shows how to code a small model transient pvrogram. 


cseg 
- (code) 
dseg 
org 100h 
P (data) 
end 
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2.5 The Compact Memory Model 


The Compact Model is assumed when code and data groups are. 
present, along with one or more of the remaining stack, extra, OF 
auxiliary groups. In this case, the CS, DS, and ES registers are 
set to the base addresses of their respective areas. Figure 2-3 
shows the initial configuration of segment registers in the Compact 
Model. The values of the various segment registers can be 
programmatically changed during execution by loading from the 
initial values placed in base page by the CCP, thus allowing access 
to the entire memory space. 


If the transient program intends to use the stack group as a 
stack area, the SS and SP registers must be set upon entry. The SS 
and SP registers remain in the CCP area, even if a stack group is 
defined. Although it may appear that the SS and SP registers should 
be set to address the stack group, there are two contradictions. 
First, the transient program may be using the stack group as a data 
area. In that case, the Far Call instruction used by the CCP to 
transfer control to the transient program could overwrite data in 
the stack area. Second, the SS register would logically be set to 
the base of the group, while the SP would be set to the offset of 
the end of the group. However, if the stack group exceeds 64K the 
address range from the base to the end of the group exceeds a 16-bit 
offset value. 


| ‘The following ASM-86 example shows how to code a compact model 
transient program. 


cseg 

‘ (code) 

dseg 

org 100h 

- (data) 

eseg 

: (more data) 
sseg 

‘ (stack area) 
end 
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SS: 


Coie 
CCP Stack 


SS +. SP: 


DS+0100H: 


ES: 


data 


Figure 2-3. CP/M-86 Compact Memory Model 
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2.6 Base Page Initialization 

Similar to CP/M-80, the CP/M-86 hase page contains default 
values and locations initialized by the CCP and used by the 
transient program. The base page occupies the regions from offset 
0O000H through OOFFH relative to the DS register. The values in the 
base page for CP/M-86 include those of CP/M-80, and appear in the 


Same relative vositions, as shown in Figure 2-4. 


ns + 0000: 

ps + 0003: 

DS + 0006: LDL | LD2 
pS + 0009: | BDO ppp | xxx 
ps + 000c: | Leo | vel | LE2 
pS + 000F: | BEO | BEL | xxx | 
ps + 0012: |xso | usl | 1s2 
pS + 0015: | BSO | BS1 | xxx 
DS + 0018: | LxO | Lxl 


DS + 0O0O1B: 
DS + OOLE: 
DS + 0021: 


DS + 0024: 


ci | ow 
mM 1 OOS 
o|o 
c* w 
os * 
os ie 
AEE : 
%s ~~ 
N N 


DS + 0027: BX0 

DS + 002A: 

DS + 002D: 

pS + 0030: Not 
eee Currently 

DS + OO5B: Used 


DS + 005C: 
DS + 0080: 


DS + 0100: 


Figure 2-4. 
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CP/M-86 System Guide 2.6 Base Page Initialization 


Each byte is indexed by 0, 1, and 2, corresponding to the standard 
Intel storage convention of low, middle, and high-order (most 
Significant) byte. "xxx" in Figure 2-4 marks unused bytes. [C is 
the last code group location (24-bits, where the 4 high-order bits 
equal zero). 


In the 8080 Model, the low order bytes of LC (LCO and LCl) 
never exceed OFFFFH and the high order byte (LC2) is alwavs zero. 
BC is base paragraph address of the code group (16-bits). LD and BD 
Provide the last vosition and paragraph base of the data group. The 
last position is one byte less than the group length. Tt should be 
noted that bytes IDO and LD1l appear in the same relative vositions 
of the base page in both CP/M-80 and CP/M-86, thus easing the 
program translation task. The M80 byte is equal to 1 when the 8080 
Memory Model is in use. LE and BE provide the length and paragraph 
base of the ovtional extra group, while LS and BS give the optional] 
Stack group length and base. The bytes marked LX and BX correspond 
to a set of four ovtional independent groups which may he required 
for programs which execute using the Compact Memorv Model. The 
initial values for these descrivotors are derived from the header 
record in the memory image file, described in the following section. 


2.7 Transient Program Load and Exit 


Similar to CP/M-80, the CCP parses uv to two filenames 
following the command and places the proverly formatted FCB’s at 
locations 005CH and OO6CH in the base page relative to the nS 
register. (Inder CP/M-80, the default DMA address is initialized to 
OO80H in the base page. Due to the segmented memory of the 8086 and 
8088 processors, the DMA address is divided into two varts: the DMA 
Segment address and the NMA offset. Therefore, under CP/M-86, the 
default DMA base is initialized to the value of DS, and the default 
DMA offset is initialized to OO80H. Thus, CP/M-80 and CP/M-86 
Operate in the same way: both assume the default MDMA buffer 
occupies the second half of the base page. 


The CCP transfers control to the transient program through an 
8086 "Far Call." The transient program may choose to use the 96-byte 
CCP stack and optionally return directly to the Cccp upon program 
termination by executing a "Far Return." Program termination also 
occurs when BDOS function zero is executed. Note that function zero 
can terminate a program without removing the program from memory or 
changing the memory allocation state (see Section 4.2). The 
Operator may terminate program execution by typing a single CONTROL- 
C during line edited input which has the same effect as the program 
executing BNOS function zero. Wnlike the operation of CP/M-80, no 
disk reset occurs and the CCP and BDOS modules are not reloaded from 
disk upon program termination. 
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Section 3 
Command (CMD) File Generation 


As mentioned previously, two utility programs are provided with 
CP/M-86, called GENCMD and LMCMD, which are used to produce CMD 
memory image files suitable for execution under CP/M-86. GENCMD 
accepts Intel 8086 "hex" format files as input, while LMCMD reads 
Intel L-module files output from the standard Intel LOC86 Object 
Code Locator utility. GENCMD is used to process output from the 
Digital Research ASM-86 assembler and Intel’s OH86 utility, while 
LMCMD is used when Intel compatible developmental software is 
available for generation of programs targeted for CP/M-86 operation. 


3.1 Intel 8086 Hex File Format 


GENCMD input is in Intel “hex" format produced by both the 
Digital Research ASM-86 assembler and the standard Intel OH36 
utility program (see Intel document #9800639-03 entitled "MCS-86 
Software Development Utitities Operating Instructions for ISIS-II 
Users"). The CMD file produced by GENCMD contains a header record 
which defines the memory model and memory size requirements for 
loading and executing the CMD file. 


An Intel "hex" file consists of the traditional sequence of 
ASCII records in the following format: 


Dp fefelalelelefatala] ~~ - dalele 


where the beginning of the record is marked by an ASCII colon, and 
each subsequent digit position contains an ASCII hexadecimal digit 
in the range 0-9 or A-F. The fields are defined in Table 3-1. 
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Table 3-l. Intel Hex Field Definitions 


Record Length O00-FF (0-255 in decimal) 


Load Address 


Record Type: 

00 data record, loaded starting at offset 
aaaa from current base paragraph 

01 end of file, cc = FF 

02 extended address, aaaa is paragraph 
base for subsequent data records 

03 start address is aaaa (ignored, IP set 

according to memory model in use) 


The following are output from ASM-86 only: . 
81 same as 00, data belongs to code segment 

82 same as 00, data belongs to data segment 

83 same as 00, data belongs to stack segment 

84 same as 00, data belongs to extra segment 

85 paragraph address for absolute code segment 
86 paragraph address for absolute data segment 
87 paragraph address for absolute stack segment 
88 paragraph address for absolute extra segment 


Data Byte 


Check Sum (00 - Sum of Previous Digits) 


All characters preceding the colon for each record are ignored. 
(Additional hex file format information is included in the ASM-86 
User’s Guide, and in Intel’s document #9800821A entitled "MCS-86 
Absolute Object File Formats.") 


3.2 Operation of GENCMD 


The GENCMD utility is invoked at the CCP level by typing 


GENCMD filename parameter-list 


where the filename corresponds to the hex input file with an assumed 
(and unspecified) file type of H86. GENCMD accepts optional 
Parameters to specifically identify the 8080 Memory Model and to 
describe memory requirements of each segment group. The GENCMD 
Parameters are listed following the filename, as shown in the 
command line above where the parameter-list consists of a sequence 
of keywords and values separated by commas or blanks. The keywords 
are: 


8080 CODE DATA EXTRA STACK Xl X2 X3 xX4 
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The 8080 keyword forces a single code group so that the BDOS load 
function sets up the 8080 Memory Model for execution, thus allowing 
intermixed code and data within a single segment. The form of this 
command is 


GENCMD filename 8080 


The remaining keywords follow the filename or the 8080 option and 
define svecific memory requirements for each segment group, 
corresponding one-to-one with the segment groups defined in the 
previous section. In each case, the values corresponding to each 
group are enclosed in square brackets and separated by commas. Each 
value is a hexadecimal number representing a paragraph address or 
segment length in voaragraph units denoted by hhhh, prefixed by a 
Single letter which defines the meaning of each value: 


Ahhhh tLoad the group at absolute location hhhh 

Bhhhh The group starts at hhhh in the hex file 

Mhhhh The group requires a minimum of hhhh * 16 bytes 
Xhhhh The group can address a maximum of hhhh * 16 bvtes 


Generally, the CMD file header values are derived directly from the 
hex file and the parameters shown above need not be included. The 
following situations, however, require the use of GENCMD parameters. . 


@® The 8080 keyword is included whenever ASM-86 is used in 
the conversion of 8080 programs to the 8086/8088 
environment when code and data are intermixed within a 
single 64K seqment, regardless of the use of CSEG and 
DSEG directives in the source program. 


@® An absolute address (A value) must be given for any group 
which must be located at an absolute location. Normally, 
this value is not svecified since CP/M-86 cannot 
generally ensure that the required memory region is 
available, in which case the CMD file cannot be loaded. 


® The B value is used when GENCMD processes a hex file 
produced by Intel’s OH86, or similar utility program that 
contains more than one group. The output from OH86 
consists of a sequence of data records with no 
information to identify code, data, extra, stack, or 
auxiliary groups. In this case, the B value marks the 
beginning address of the group named by the keyword, 
causing GENCMD to load data following this address to the 
named group (see the examples below). Thus, the B value 
is normally used to mark the boundary between code and 
data segments when no segment information is included in 
the hex file. Files produced by ASM-86 do not require 
the use of the B value since segment information is 
included in the hex file. | : 


All Information Presented Here is Proprietary to Digital Research 


L7 


CP/M-86 System Guide 3.2 Operation of GENCMN 


@ The minimum memory value (M value) is included only when 
the hex records do not define the minimum memory 
requirements for the named group. Generally, the code 
group size is determined precisely by the data records 
loaded into the area. That is, the total svace required 
for the group is defined by the range between the lowest 
and highest data byte addresses. The data group, 
however, may contain uninitialized storage at the end of 
the group and thus no data records are present in the hex 
file which define the highest referenced data item. The 
highest address in the data group can be defined within 
the source vrogram by including a "DB 0" as the last data 
item. Alternatively, the M value can be included to 
allocate the additional space at the end of the groun. 
Similarly, the stack, extra, and auxiliary group sizes 
must be defined using the M value unless the highest 
addresses within the groups are implicitly defined by 
data records in the hex file. 


e The maximum memory size, given by the X value, is 
generally used when additional free memory may be needed 
for such purposes as I/O buffers or svmbol tables. If 
the data area size is fixed, then the X parameter need 
not be included. In this case, the X value is assumed to 
be the same as the M value. The value XFFFF allocates 
the largest memory region available but, if used, the 
transient program must be aware that a three-byte length 
field is produced in the base page for this group where 
the high order byte may be non-zero. Programs converted 
directly from CP/M-80 or programs that use a 2-byte 
pointer to address buffers should restrict this value to 
XFFF or less, producing a maximum allocation length of 
OFFFOH bytes. | 


The following GENCMD command line transforms the file X.H86 
into the file X.CMD with the proper header record: 
gencmd x code[a40] data[m30,xfff] 
In this case, the code group is forced to paragraph address 40H, or 


equivalently, byte address 400H. The data group requires a minimum 
of 300H bytes, but can use up to OFFFOH bytes, if available. 
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Assuming a file Y.H86 exists on drive B containing Intel hex 
records with no interspersed segment information, the command 


gencmd b:yv data[b30,m20] extra[b50] stack[m40] xl[m40] 


produces the file Y.CMD on drive B by selecting records beginning 
at address 0000H for the code segment, with records starting at 
300H allocated to the data segment. The extra segment is filled 
from records beginning at 500H, while the stack and auxiliary 
segment #1 are uninitialized areas requiring a minimum of 400H 
bytes each. In this example, the data area requires a minimum of 
200H bytes. Note again, that the B value need not be included if 
the Digital Research ASM-86 assembler is used. 


3.3 Operation of LMCMD 


The LMCMD utility operates in exactly the same manner as 
GENCMD, with the exception that ULMCMD accepts an Intel. L-module 
file as input. The primary advantage of the L-module format is 
that the file contains internally coded information which defines 
values which would otherwise be required as parameters to GENCMN, 
such the beginning address of the group’s data segment. Currently, 
however, the only language processors which use this format are the 
Standard Intel development pvackagesy although various indevendent 
vendors will, most likely, take advantage of this format in the 
future. 
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3.4 Command (CMD) File Format 


The CMD file produced by GENCMD and LMCMD consists of the 
128-byte header record followed immediately by the memory image. 
Under normal circumstances, the format of the header record is of 
no consequence to a programmer. For completeness, however, the 
various fields of this record are shown in Figure 3-l. 


—_————"" 1128 Bytes er 


Code, 
Data, 
Extra, 
Stack, 
Auxiliary 


Figure 3-1. CMD File Header Format 


In Figure 3-l, GD#2 through GD#8 represent "Group Descriptors." 
Each Group Descriptor corresponds to an independently Loaded 
program unit and has the following fields: 


8-bit 16-bit 16-bit 16-bit 16-bit 


where G-Form describes the group format, or has the value zero if 
no more descriptors follow. If G-Form is non-zero, then the 8-bit 
value is parsed as two fields: 


G-Form: 
4-bit 4-bit 


The G-Type field determines the Group Descriptor type. The valid 
Group Descriptors have a G-Type in the range 1 through 9, as shown 
in Table 3-2 below. 
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Table 3-2. Group Descriptors 


Group Type | 


Code Group 
Data Group 
Extra Group 
Stack Group 
Auxiliary Group #1 
Auxiliary Group #2 
Auxiliary Group #3 
Auxiliary Group #4 
Shared Code Group 

14 Unused, but Reserved | 
Escape Code for Additional Types 


IpwodDdNHAU RWDN PF 


~ 
© 

~ 

Ul 


All remaining values in the group descriptor are given in 
increments of 16-byte paragraph units with an assumed low-order 0 
nibble to complete the 20-bit address. G-Length gives the number 
of paragraphs in the group. Given a G-length of 0080H, for 
example, the size of the group is 00800H = 2048D bytes. A-Base 
defines the base paragraph address for a non-relocatable group 
while G-Min and G-Max define the minimum and maximum size of the 
memory area to allocate to the group. G-Type 9 marks a "pure" code 
group for use under MP/M-86 and future versions of CP/M-86. 
Presently a Shared Ccde Group is treated as a non-shared Program 
Code Group under CP/M-86. 


The memory model described by 'a header record is implicitly 
determined by the Group Descriptors. The 8080 Memory Model is 
assumed when only a code group is present, since no independent 
data group is named. The Small Model is implied when both a code 
and data group are present, but no additional group descriptors 
occur. Otherwise, the Compact Model is assumed when the CMD file 
is loaded. | 
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Section 4 
Basic Disk Operating System Functions 


This section presents the interface conventions which allow 
transient program access to CP/M-86 BDOS and BIOS functions. The 
BDOS calls correspond closely to CP/M-80 Version 2 in order to 
simplify translation of existing CP/M-80 programs for operation 
under CP/M-86. BDOS entry and exit conditions are described first, 
followed by a presentation of the individual BDOS function calls. 


4.1  BDOS Parameters and Function Codes 


Entry to the BDOS is accomplished through the 8086 software 
interrupt #224, which is reserved by Intel Corporation for use by 
CP/M-86 and MP/M-86. The function code is passed in register CL 
with byte parameters in DL and word parameters in DX. Single byte 
values are returned in AL, word values in both AX and BX, and double 
word values in ES and BX. All Segment registers, except ES, are 
saved upon entry and restored upon exit from the BDOS (corresponding 
to PL/M-86 conventions). Table 4-1 summarizes input and output 
parameter passing: 


Table 4-1. BDOS Parameter Summary 


BDOS Entry Registers BDOS Return Registers 


CL Function Code Byte value returned in AL | 

DL Byte Parameter Word value returned in both AX and BX 
DX Word Parameter Double-word value returned with 

DS Data Segment offset in BX and 


segment in ES 


Note that the CP/M-80 BDOS requires an "information address" as 
input to various functions. This address usually provides buffer or 
File Control Block information used in the system call. In CP/M-86, 
however, the information address is derived from the current DS 
register combined with the offset given in the DX register. That 
is, the DX register in CP/M-86 performs the same function as the DE 
pair in CP/M-80, with the assumption that DS is properly set. This 
poses no particular problem for programs which use only a single 
data segment (as is the case for programs converted from CP/M-80), 
but when the data group exceeds a single segment, you must ensure 
that the DS register is set to the segment containing the data area 
related to the call. It should also be noted that zero values are 
returned for function calls which are out-of-range. 
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A list of CP/M-86 calls is given in Table 4-2 with an asterisk 
following functions which differ from or are added to the set of 
CP/M-80 Version 2 functions. 


Table 4-2. CP/M-86 BDOS Functions 


C—O 1 


System Reset Return Login Vector 
Console Input * Return Current Nisk 

Console Output 26 Set DMA Address 

Reader Input 27* Get Addr (Alloc) 

Punch Output 28 Write Protect Nisk 

List Outout 29 Get Addr(R/O Vector) 

Direct Console I/0 30 Set File Attributes 

Get I/O Byte 31* Get Addr (Disk Parms) 

Set I/O Byte 32 Set/Get User Code 

Print String 33 Read Random 

10 Read Console Buffer 34 Write Random 

ll Get Console Status 35 Compute File Size 

12 Return Version Number 36 Set Random Record 

13 Reset Disk System 37* Reset drive 

14 Select Disk 40 Write Random with Zero Fill 
15 Oven File 50* Direct BIOS Call 

16 Close File 51* Set DMA Segment Base 

17 Search for First 52* Get NMA Segment Base 

18 Search for Next 53* Get Max Memory Available 

19 Delete File 54* Get Max Mem at Abs Location 
20 Read Sequential 55* Get Memory Region 

21 Write Sequential 56* Get Absolute Memory Region 
22 Make File 57* Free memory region 

Rename File 58* Free all memory 

Program load 


te 


+ 


WON ADU hBWN-H O 


The individual BDOS functions are described below in three 
sections which cover the simple functions, file operations, and 
extended operations for memory management and program loading. 
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4.2 Simple BDOS Calls 


The first set of BDOS functions cover the range 0 through 12, 
and perform simple functions such as system reset and single 
character I/O. | 


Entry Return 
CL: OOH FUNCTION 0 
DL: Abort SYSTEM RESET 
Code 


The system reset function returns control to the CP/M operating 
System at the CCP command level. The abort code in DL has two 
possible values: if DL = 00H then the currently active program is 
terminated and control is returned to the CCP. If DL is a O1H, the 
program remains in memory and the memory allocation state remains 
unchanged. 


Entry Return 
sere 
CL: 01H FUNCTION 1 AL: ASCII Character 


CONSOLE INPUT 


; The console input function reads the next character from the 
logical console device (CONSOLE) to register AL. Graphic 
characters, along with carriage return, line feed, and backspace 
(CONTROL-H) are echoed to the console. Tab characters (CONTROL-1I) 
are expanded in columns of eight characters. The BDOS does not 
return to the calling program until a character has been typed, thus 
suspending execution if a character is not ready. 


Entry Return 
CL: 02H | FUNCTION 2 
DL: ASCII CONSOLE OUTPUT 
Character 


The ASCII character from DL is sent to the logical console. 
Tab characters expand in columns of eight characters. In addition, 
a check is made for start/stop scroll (CONTROL-S). 
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Entry Return 


te 
CL: 03H FUNCTION 3 AL: ASCII Character 


READER INPUT 


The Reader Input function reads the next character from the 


logical reader (READER) into register AL. Control does not return 
until the character has been read. 


Entry 
ae ETE 
CL: 04H FUNCTION 4 
DL: ASCII PUNCH OUTPUT 
Character 


The Punch Output function sends the character from register DL 
to the logical punch device (PUNCH) . 


Entry Return 
eee IN 
CL: O5H FUNCTION 
DL: ASCII LIST OUTPUT 

Character 


The List Output function sends the ASCII character in register 
DL to the logical list device (LIST). 


id 
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Entry Return 
pen 


CL: 06H FUNCTION 6 AL: char or status 


DL: OFFH (input)|| DIRECT CONSOLE I/O (no value) 


Or 

OFEH (status) 
or 

char (output) 


Direct console I/O is supported under CP/M-86 for those 
specialized applications where unadorned console input and output is 
required. Use of this function should, in general, be avoided since 
it bypasses all of CP/M-86°s normal control character functions 
(e.g., CONTROL-S and CONTROL-P). Programs which perform direct I/0 
through the BIOS under previous releases of CP/M-80, however, should 
be changed to use direct I/O under the BDOS so that they can be 
fully supported under future releases of MP/M and CP/M. 


Upon entry to function 6, register DL either contains (1) a 
hexadecimal FF, denoting a CONSOLE input request, OF (2) a 
hexadecimal FE, denoting a CONSOLE status request, or (3) an ASCII 
character to be output to CONSOLE where CONSOLE is the logical 
console device. If the input value is FF, then function 6 directly 
calls the BIOS console input primitive. The next console input 
character is returned in AL. If the input value is FE, then function 
6 returns AL = 00 if no character is ready and AL = FF otherwise. 
If the input value in DL is not FE or FF, then function 6 assumes 
that DL contains a valid ASCII character which is sent to the 
console. 


Entry ; Return 
AR TREATS TET 
CL: 07H FUNCTION 7 AL: I/O Byte Value 


GET I/O BYTE 


The Get I/O Byte function returns the current value of IOBYTE 
in register AL. The IOBYTE contains the current assignments for the 
logical devices CONSOLE, READER, PUNCH, and LIST provided the IOBYTE 
facility is implemented in the BIOS. 
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FUNCTION 8 


DL: I/O Byte 


SET I/O BYTE 
Value . 


The Set I/O Byte function changes the system IOBYTF value to 
that given in register DL. This function allows transient program 
access to the IOBYTE in order to modify the current assignments for 
the logical devices CONSOLE, READER, PUNCH, and LIST. 


Entry 
es a 
CL: O9H FUNCTION 9 
DX: String PRINT STRING 
Offset 


The Print String function sends the character string stored in 
memory at the location given by DX to the logical console device 
(CONSOLE), until a "$" is encountered in the string. Tabs are 
expanded as in function 2, and checks are made for start/stop scroll 
and printer echo. 


Entry Return 
ee a 
ANNE LI ETE TO es ae 
CL: OAH FUNCTION 10 Console Characters 
DX: Buffer READ CONSOLE BUFFER in Buffer 


Offset 


All Information Presented Here is Proprietary to Digital Research 


28 


CP/M-86 System Guide 4.2 Simple BDOS Calls 


The Read Buffer function reads a line of edited console invut into a 
buffer addressed by register NX from the logical console device 
(CONSOLE). Console invut is terminated when either the input buffer 
is filled or when a return (CONTROL-M) or a line feed (CONTROL-J) 
character is entered. The input buffer addressed by DX takes the 
form: 


DX: +0 +1 +2 +3 +4 +5 +6 +7 +8 c. te +n 
SG GG 


where "mx" is the maximum number of characters which the buffer will 
hold, and "nc" is the number of characters placed in the buffer. 
The characters entered by the overator follow the "nc" value. The 
value "mx" must be set orior to making a function 10 call and mav 
range in value from 1 to 255. Setting mx to zero is equivalent to 
setting mx to one. The value "nc" is returned to the user and may 
range from 0 to mx. If ne < mx, then uninitialized positions follow 
the last character, denoted by "??" in the above figure. Note that 
a terminating return or line feed character is not placed in the 
buffer and not included in the count "nc". 


A number of editing control functions are supported during 
console input under function 10. These are Summarized in Table 4-3. 


Table 4-3. Line Editing Controls 


Keystroke 


rub/del removes and echoes the last character 
CONTROL-C reboots when at the beginning of line 
CONTROL-E causes physical end of line 

CONTROL-H backspaces one character position 
CONTROL-J (Line feed) terminates input line 
CONTROL-M (return) terminates input line | 
CONTROL-R retypes the current line after new line 
CONTROL-U removes current line after new line 
CONTROL-X backspaces to beginning of current line 


Certain functions which return the carriage to the leftmost position 
(e.g., CONTROL-X) do so only to the column position where the prompt 
ended. This convention makes operator data input and line 
correction more legible. | 
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CL: OBH FINCTION 1l AL: Console Status 


GET CONSOLE STATUS 


The Console Status function checks to see if a character has 
been typed at the logical console device (CONSOLE). If a character 
is readv, the value 01H is returned in register AL. Otherwise a 00H 
value is returned. 


Entry Return 


CL: OCH FUNCTION 12 BX: Version Number 


RETURN VERSION NUMBER 


Function 12 provides information which allows version 
independent programming. A two-bvte value is returned, with BH = 00 
designating the CP/M release (BH = 01 for MP/M), and BL = 00 for all 
releases previous to 2.0. CP/M 2.0 returns a hexadecimal 20 in 
register BL, with subsequent version 2 releases in the hexadecimal 
range 21, 22, through 2F. To provide version number compatibility, 
the initial release of CP/M-86 returns a 2.2. 


4.3 BDOS File Operations 


Functions 12 through 52 are related to disk file operations 
under CP/M-86. In many of these operations, DX provides the NS- 
relative offset to a file control block (FCB). The File Control 
Block (FCB) data area consists of a sequence of 33 bytes for 
sequential access, or a sequence of 36 bytes in the case that the 
file is accessed randomly. The default file control block normally. 
located at offset O05CH from the DS register can be used for random 
access files, since bytes 007NH, OO7EH, and OO7FH are available for 
this purpose. Here is the FCB format, followed by definitions of 
each of its fields: 
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00 01 02 ... 08 09 10 11 12 13 14 15 16 ... 31 32 33 34 35 


where 
dr drive code (0 - 16) 
0 => use default drive for file 
1 => auto disk select drive A, 
2 => auto disk select drive B, 


16=> auto disk select drive P. 


£137. ts contain the file name in ASCII 
upper case, with high bit = 0 


tl,t2,t3 contain the file type in ASCII 
upper case, with high bit = 0 
tl’, t2*, and t3° denote the high 
bit of these positions, 
tl* = 1 => Read/Only file, 
t2° = 1 => SYS file, no DIR list 


ex contains the current extent number, 
normally set to 00 by the user, but 
in range 0 - 31 during file I/0 


sl reserved for internal system use 


$2 reserved for internal system use, set 
to zero on call to OPEN, MAKE, SEARCH 


rc record count for extent "ex," 
takes on values from 0 - 128 


d0Q...dn filled-in by CP/M, reserved for 
system use | | 


Cr current record to read or write in 


a sequential file operation, normally 
set to zero by user 


r0,rl,r2 optional random record number in the 
range 0-65535, with overflow to r2, 
r0,rl constitute a 16-bit value with 
low byte r0, and high byte rl 


For users of earlier versions of CP/M, it should be noted in 
passing that both CP/M Version 2 and CP/M-86 perform directory 
operations in a reserved area of memory that does not affect write 
buffer content, except in the case of Search and Search Next where 
the directory record is copied to the current DMA address. 
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There are three error situations that the BDOS may encounter during 
file processing, initiated as a result of a BDOS File I/O function 
call. When one of these conditions is detected, the BDOS issues the 
following message to the console: 


BDOS ERR ON x: error 


where x is the drive name of the drive selected when the error 
condition is detected, and "error" is one of the three messages: 


BAD SECTOR SELECT R/O 


These error situations are trapped by the BDOS, and thus the 
executing transient program is temporarily halted when the error is 
detected. No indication of the error situation is.returned to the 
transient program. 


The "BAD SECTOR" error is issued as the result of an error 
condition returned to the BDOS from the BIOS module. The BNOS makes 
BIOS sector read and write commands as part of the execution of BDOS 
file related system calls. If the BIOS read or write routine 
detects a hardware error, it returns an error code to the BDOS 
resulting in this error message. The operator may respond to this 
error in two ways: a CONTROL-C terminates the executing program, 
while a RETURN instructs CP/M-86 to ignore the error and allow the 
program to continue execution. 


The "SELECT" error is also issued as the result of an error 
condition returned to the BDOS from the BIOS module. The BNOS makes 
a BIOS disk select call prior to issuing any BIOS read or write to a 
particular drive. If the selected drive is not supported in-the 
BIOS module, it returns an error code to the BDOS resulting in this 
error message. CP/M-86 terminates the currently running vrogram and 
returns to the command level of the CCP following any input from the 
console. 


The "R/O" message occurs when the BDOS receives a command to 
write to a drive that is in read-only status. MDrives may be placed 
in read-only status explicitly as the result of a STAT command or 
BDOS function call, or implicitly if the BDOS detects that disk 
media has been changed without performing a “warm start." The 
ability to detect changed media is optionally included in the BIOS, 
and exists only if a checksum vector is included for the selected 
drive. Upon entry of any character at the keyboard, the transient 
program is aborted, and control returns to the CCP. 
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Entry Return 
CL: ODH FUNCTION 13 


RESET DISK SYSTEM 


The Reset Disk Function is used to programmatically restore the 
file system to a reset state where all disks are set to read/write 
(see functions 28 and 29), only disk drive A is selected. This 
function can be used, for example, by an application program which 
requires disk changes during operation. Function 37 (Reset Drive) 
can also be used for this purpose. 


Entry Return 
i a aera: 
ATL EAST TEETER PL SST TS 
CL: OEFH FUNCTION 14 
DL: Selected SELECT DISK 
Disk 


The Select Disk function designates the disk drive named in 
register DL as the default disk for subsequent file operations, with 
DL = O for drive A, 1 for drive B, and so-forth through 15 
corresponding to drive P in a full sixteen drive system. In 
addition, the designated drive is logged-in if it is currently in 
the reset state. Logging-in a drive places it in "on-line" status 
which activates the drive’s directory until the next cold start, 
warm start, disk system reset, or drive reset operation. FCB’s 
which specify drive code zero (dr = 00H) automatically reference the 
currently selected default drive. Drive code values hetween 1 and 
16, however, ignore the selected default drive and erbectey 
reference drives A through P. | 


Entry 
LETTER AA MERTON 
CL: OFH FUNCTION 15 
DX: FCB OPEN FILE 
Offset 


The Open File operation is used to activate a FCB specifying a 
file which currently exists in the disk directory for the currently 
active user number. The BDOS scans the disk directory of the drive 
specified by byte 0 of the FCB referenced by DX for a match in 
positions 1 through 12 of the referenced FCB, where an ASCII 
question mark (3FH) matches any directory character in any of these 
positions. Normally, no question marks are included and, further, 
byte "ex" of the FCB is set to zero before making the open call. 
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If a directory element is matched, the relevant directory 
information is copied into bytes d0 through dn of the FCB, thus 
allowing access to the files through subsequent read and write 
Operations. Note that an existing file must not be accessed until a 
successful open operation is completed. Further, an FCB not 
activated by either an open or make function must not be used in 
BDOS read or write commands. Yoon return, the open function returns 
a "directory code" with the value 0 through 3 if the open was 
Successful, or OFFH (255 decimal) if the file cannot be found. Tf 
question marks occur in the FCB then the first matching FCB is 
activated. Note that the current record ("cr") must be zeroed by 
the program if the file is to be accessed sequentially from the 
first record. 


Entry Return 
CL: 1048 FUNCTION 16 AL: Return Code 
DX: FCB CLOSE FILE 

Offset 


The Close File function performs the inverse of the open file 
function. Given that the FCB addressed by DX has been previously 
activated through an open or make function (see functions 15 and 
22), the close function permanently records the new FCB in the 
referenced disk directory. The FCB matching process for the close 
is identical to the open function. The directory code returned for 
a successful close operation is 0, l, 2, or 3, while a OFFH (255 
decimal) is returned if the file name cannot be found in the 
directory. A file need not be closed if only read operations have 
taken place. If write operations have occurred, however, the close 
operation is necessary to permanently record the new directory 
information. 
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Entry | Return 
eee ee ees od ae ant 
CL: 11H FUNCTION 17 AL: Directory 
* Code 
DX: FCB SEARCH FOR FIRST 
Offset 


Search First scans the directory for a match with the file 
given by the FCB addressed by DX. The value 255 (hexadecimal FF) is 
returned if the file is not found, otherwise 0, 1, 2, or 3 is 
returned indicating the File is present. In the case that the file 
is found, the buffer at the current DMA address is filled with the 
record containing the directory entry, and its relative starting 
position is AL * 32 (i.e., rotate the AL register left 5 bits). 
Although not normally required for application programs, the 
directory information can be extracted from the buffer at this 
position. 


An ASCII question mark (63 decimal, 3F hexadecimal) in any 
position from "fl" through "ex" matches the corresponding field of 
any directory entry on the default or auto-selected disk drive. If 
the "dr" field contains an ASCII question mark, then the auto disk 
select function is disabled, the default disk is searched, with the 
search function returning any matched entry, allocated or free, . 
belonging to any user number. This latter function is not normally 
used by application programs, but does allow complete flexibility to 
scan all current directory values. If the "dr" field is not a 
question mark, the "s2" byte is automatically zeroed. 


Entry Return 
ee | Ce a 

CL: 12H FUNCTION 18 AL: Directory 
Code 


SEARCH FOR NEXT 


The Search Next function is similar to the Search First 
function, except that the directory scan continues from the last 
matched entry. Similar to function 17, function 18 returns the. 
decimal value 255 in A when no more directory items match. In terms 
of execution sequence, a function 18 call must follow either a 
function 17 or function 18 call with no other intervening BDOS disk 
related function calls. | 
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Entry Return 
nce Ac 
CL: 13H FUNCTION 19 AL: Return Code 
DX: FCB DELETE FILE 
Offset 


The Delete File function removes files which match the FCB 
addressed by Dx. The filename and type may contain ambiguous 
references (i.e., question marks in various positions), but the 
drive select code cannot be ambiguous, as in the Search and Search 
Next functions. Function 19 returns a OFFH (decimal 255) if the 
referenced file or files cannot be found, otherwise a value of zero 
is returned. 


Entry Return 
eee ea es 
CL: FUNCTION 20 AL: Return Code 


DX: READ SEQUENTIAL 


Given that the FCB addressed by DX has been activated through 
an open or make function (numbers 15 and 22), the Read Sequential 
function reads the next 128 byte record from the file into memory at 
the current DMA address. The record is read from position "cr" of 
the extent, and the "cr" field is automatically incremented to the 
next record position. If the "cr" field overflows then the next 
logical extent is automatically opened and the "cr" field is reset 
to zero in preparation for the next read operation. The "cr" field 
must be set to zero following the open call by the user if the 
intent is to read sequentially from the beginning of the file. The 
value OOH is returned in the AL register if the read operation was 
Successful, while a value of 01H is returned if no data exists at 
the next record position of the file. Normally, the no data 
situation is encountered at the end of a file. However, it can also 
occur if an attempt is made to read a data block which has not been 
previously written, or an extent which has not been created. These 
situations are usually restricted to files created or appended by 
use of the BDOS Write Random commmand (function 34). 
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Entry Return 
a SN oo 
CL: 15H FUNCTION 21 AL: Return Code 
DX: FCB WRITE SEQUENTIAL 
Offset 


Given that the FCB addressed by NX has been activated through 
an open or make function (numbers 15 and 22), the Write Sequential 
function writes the 128 byte data record at the current DMA address 
to the file’ named by the FCB. The record is placed at position "cr" 
of the file, and the "cr" field is automatically incremented to the 
next record position. If the "cr" field overflows then the next 
logical extent is automatically opened and the "cr" field is reset 
to zero in preparation for the next write operation. Write 
operations can take place into an existing file, in which case newly 
written records overlay those which already exist in the file. The 
"or" field must be set to zero following an open Or make call by the 
user if the intent is to write sequentially from the beginning of 
the file. Register AL = 00H upon return from a successful write 
operation, while a non-zero value indicates an unsuccessful write 
due to one of the following conditions: 


01 No available directory space - This condition occurs when 
the write command attempts to create a new extent that. 
requires a new directory entry and no available directory 
entries exist on the selected disk drive. 


02 No available data block - This condition is encountered 
when the write command attempts to allocate a new data 
block to the file and no unallocated data blocks exist on 
the selected disk drive. 


Return 
a Ny a 
FUNCTION 22 AL: Return Code 


MAKE FILE 


The Make File operation is similar to the open file operation 
except that the FCB must name a file which does not exist in the 
currently referenced disk directory (i.e., the one named explicitly 
by a non-zero "dr" code, or the default disk if "dr" is zero). The 
BDOS creates the file and initializes both the directory and main 
memory value to an empty file. The programmer must ensure that no 
duplicate file names occur, and a preceding delete operation is 
sufficient if there is any possibility of duplication. Upon return, 
register A= 0, 1, 2, or 3 if the operation was successful and OFFH 
(255 decimal) if no more directory space is available. The make 
function has the side-effect of activating the FCB and thus a 
subsequent open is not necessary. 
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Entry Return 
es PX 
CL: 17H FUNCTION 23 AL: Return Code 
DX: FCB RENAME FILE 
Offset 


The Rename function uses the FCB addressed by DX to change all 
directory entries of the file specified by the file name in the 
first 16 bytes of the FCB to the file name in the second 16 bytes. 
It is the user’s responsibility to insure that the file names 
specified are valid CP/M unambiguous file names. The drive code 
"dr" at position 0 is used to select the drive, while the drive code 
for the new file name at position 16 of the FCB is ignored. Upon 
return, register AL is set to a value of zero if the rename was 
successful, and OFFH (255 decimal) if the first file name could not 
be found in the directory scan. 


Entry Return 
eR TC ——— 
CL: 18H FUNCTION 24 BX: Login Vector 
BX: Login RETURN LOGIN 
Vector | VECTOR 


The login vector value returned by CP/M-86 is a 16-bit value in 
BX, where the least significant bit corresponds to the first drive 
A, and the high order bit corresponds to the sixteenth drive, 
labelled P. A "0" bit indicates that the drive is not on-line, 
while a "1" bit marks an drive that is actively on-line due to an 
explicit disk drive selection, or an implicit drive select caused by 
a file operation which specified a non-zero "dr" field. 


Entry Return 
a a A I ETO I 


CL: 19H FUNCTION 25 AL: Current Disk 


RETURN CURRENT 
DISK 


Function 25 returns the currently selected default disk number 
in register AL. The disk numbers range from 0 through 15 
corresponding to drives A through P. 
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Entry Return 
(EEE SNES a at 
CL: lAH FUNCTION 26 
DX: DMA SET DMA 
Offset 


ADDRESS 


"MMA" is an acronym for Direct Memory Address, which is often 
used in connection with disk controllers which directly access the 
memory of the mainframe computer to transfer data to and from the 
disk subsystem. Although many computer systems use non-DMA access 
(i.e., the data is transfered through programmed I/0 operations) , 
the DMA address has, in CP/M, come to mean the address at which the 
128 byte data record resides before a disk write and after a disk 
read. In the CP/M-86 environment, the Set DMA function is used to 
specify the offset of the read or write buffer from the current DMA 
base. Therefore, to svecify the DMA address, both a function 26 
call. and a function 51 call are required. Thus, the DMA address 
becomes the value specified by DX plus the DMA base value until it 
is changed by a subsequent Set DMA or set DMA base function. 


Entry Return 
Nc a 


CL: 1B FUNCTION 27. BX: ALLOC Offset 


GET ADDR(ALLOC) ES: Segment base 


An “allocation vector" is maintained in main memory for each 
on-line disk drive. Various system programs use the information 
provided by the allocation vector to determine the amount of 
remaining storage (see the STAT program). Function 27 returns the 
segment base and the offset address of the allocation vector for the 
currently selected disk drive. The allocation information may, 
however, be invalid if the selected disk has been marked read/only. 


Entry Return 


CL: 1CH FUNCTION 28 


WRITE PROTECT DISK 


The disk write protect function provides temporary write 
protection for the currently selected disk. Any attempt to write to 
the disk, before the next cold start, warm start, disk system reset, 
or drive reset operation produces the message: 


Bados Err on d: R/O 
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Entry | Return 
$$ eee l*DF OT 
CL: LDH FUNCTION 29 BX: R/O Vector Value 


GET REAN/ONLY 
VECTOR 


Function 29 returns a bit vector in register BX which indicates 
drives which have the temporary read/only bit set. Similar to 
function 24, the least significant bit corresponds to drive A, while 
the most significant bit corresponds to drive P. The R/O bit is set 
either by an explicit call to function 28, or by the automatic 
software mechanisms within CP/M-86 which detect changed disks. 


Entry } Return 
nD, 
CL: LEH FUNCTION 30 AL: Return Code 
DX: FCB SET FILE 
Offset ATTRIBUTES 


The Set File Attributes function allows programmatic 
manipulation of permanent indicators attached to files. Tn 
particular, the R/O, System and Archive attributes (tl”, t2°, and 
t3°) can be set or reset. The DX pair addresses a FCB containing a 
file name with the appropriate attributes set or reset. It is the 
user~s responsibility to insure that an ambiquous file name is not 
specified. Function 30 searches the default disk drive directory 
area for directory entries that belong to the current user number 
and that match the FCB specified name and type fields. All matching 
directory entries are updated to contain the selected indicators. 
Indicators f£1° through £4” are not presently used, but may he useful 
for applications programs, since they are not involved in the 
matching process during file open and close operations. Indicators 
£5“ through £8* are reserved for future system expansion. The 
currently assigned attributes are defined as follows: 


tl*: The R/O attribute indicates if set that the file 
is in read/fonly status. BDNOS will not allow write 
commands to be issued to files in R/O status. 


t2°: The System attribute is referenced by the CP/M DIR 
utility. If set, DIR will not display the File in 
a directory display. 
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t3°: The Archive attribute is reserved but not actually 
used by CP/M-86 If€ set it indicates that the file 
has been written to back ud storage by a user 
written archive program. To implement this 
facility, the archive program sets this attribute 
when it copies a file to back up storage; any 
programs updating or creating files reset this 
attribute. Further, the archive program backs uo 
only those files that have the Archive attribute 
reset. Thus, an automatic back up facilitv 
restricted to modified files can be easily 
implemented. 


Function 30 returns with register AL set to OFFH (255 decimal) 
if the referenced file cannot be found, otherwise a value of zero is 
returned. 


Entry | 7 Return 


FUNCTION 31 BX: DPB Offset 


GET ADDR 
(DISK PARMS) 


ES: Segment Base 


The offset and the seqment base of the BIOS resident disk 
Darameter block of the currently selected drive are returned in BX. 
and ES as a result of this function call. This control block can be 
used for either of two vourvoses. First, the disk parameter values 
can be extracted for display and space computation purposes, or 
transient programs can dynamically change the va)ues of current disk 
Parameters when the disk environment changes, if required. 
Normally, avplication programs will not require this facility. 
Section 6.3 defines the BIOS disk parameter block. 


Entry Return 
CL: 20H FUNCTION 32 Al: Current Code 
Or no value 
NL: OFFH(get) SET/GET 
or USER CODE 
User Code 
(set) 


An application program can mange or interrogate the currently 
active user number by calling function 32. If register DL = OFFH, 
then the value of the current user number is returned in register 
AL, where the value is in the range 0 to 15. If register DL 1s not 
OFFH, then the current user number is changed to the value of DI 
(modulo 16). 
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Entry Return 


eae IN 
CL: 21H FUNCTION 33 AL: Return Code 
DX: FCB READ RANDOM 
Offset 


The Read Random function is similar to the sequential file read 
operation of previous releases, except that the read operation takes 
place at a particular record number, selected by the 24-bit value 
constructed from the three byte field following the FCB (byte 
positions r0 at 33, rl at 34, and r2 at 35). Note that the sequence 
of 24 bits is stored with least significant byte first (r0), middle 
byte next (rl), and high byte last (r2). CP/M does not reference 
byte r2, except in computing the size of a file (function 35). Byte 
r2 must be zero, however, since a non-zero value indicates overflow 
past the end of file. | 


Thus, the r0,rl byte pair is treated as a double-byte, or 
"word" value, which contains the record to read. This value ranges 
from 0 to 65535, providing access to any particular record of any 
size file. In order to access a file using the Read Random 
function, the base extent (extent 0) must first be opened. Although 
the base extent may or may not contain any allocated data, this 
ensures that the FCB is properly initialized for subsequent random 
access operations. The selected record number is then stored into 
the random record field (r0,rl), and the BDOS is called to read the 
record. Upon return from the call, register AL either contains an 
error code, as listed below, or the value 00 indicating the 
operation was successful. In the latter case, the buffer at the 
current DMA address contains the randomly accessed record. Note 
that contrary to the sequential read operation, the record number is 
not advanced. Thus, subsequent random read operations continue to 
read the same record. 


Upon each random read operation, the Logical extent and current 
record values are automatically set. Thus, the file can be 
sequentially read or written, starting from the current randomly 
accessed position. Note, however, that in this case, the last 
randomly read record will be re-read as you switch from random mode 
to sequential read, and the last record will be re-written as you 
switch to a sequential write operation. You can, of course, simply 
advance the random record position following each random read or 
write to obtain the effect of a sequential I/O operation. 
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Error codes returned in register AL following a random read are 
listed in Table 4-4, below. 


Table 4-4. Function 33 (Read Random) Error Codes 


Ol Reading unwritten data - This error code is returned 
when a random read operation accesses a data block which 
has not been previously written. 


02 (not returned by the Random Read command) 


03 Cannot close current extent - This error code is 
returned when BDOS cannot close the current extent prior 
to moving to the new extent containing the record 
specified by bytes r0,rl of the FCB. This error can be 
caused by an overwritten FCB or a read random operation 
on an FCB that has not been opened. 


04 Seek to unwritten extent - This error code is returned 
when a random read operation accesses an extent that has 
not been created. This error situation is equivalent to 
error Ol. 


05 (not returned by the Random Read command) 
06 Random record number out of range — This error code is 


returned whenever byte r2 of the FCB is non-zero. 


Normally, non-zero return codes can be treated as missing data, with 
zero return codes indicating operation complete. 
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Entry Return 
a aan aimndiaiamnemnmeemen con 
CL: 22H FUNCTION 34 AL: Return Code 
DX: FCB WRITE RANDOM 
Offset 


The Write Random operation is initiated similar to the Read 
Random call, except that data is written to the disk from the 
Current DMA address. Further, if the disk extent or data block 
which is the target of the write has not yet been allocated, the 
allocation is performed before the write operation continues. As in 
the Read Random operation, the random record number is not changed 
aS a result of the write. The logical extent number and current 
record positions of the file control block are set to correspond to 
the random record which is being written. Sequential read or write 
operations can commence following a random write, with the note that 
the currently addressed record is either read or rewritten again as 
the sequential operation begins. You can also simply advance the 
random record position following each write to get the effect of a 
sequential write operation. In particular, reading or writing the 
last record of an extent in random mode does not cause an automatic 
extent switch as it does in sequential mode. 


In order to access a file using the Write Random function, the 
base extent (extent 0) must first be opened. As in the Read Random 
function, this ensures that the FCB is properly initialized for 
subsequent random access operations. If the file is empty, a Make 
File function must be issued for the base extent. Although the base 
extent may or may not contain any allocated data, this ensures that 
the file is properly recorded in the directory, and is visible in 
DIR requests. 


Upon return from a Write Random call, register AL either 
contains an error code, as listed in Table 4-5 below, or the value 
00 indicating the operation was successful. 


Table 4-5. Function 34 (WRITE RANDOM) Error Codes 


Ol (not returned by the Random Write command) 


No available data block - This condition is encountered 
when the Write Random command attempts to allocate a new 
data block to the file and no unallocated data blocks 
exist on the selected disk drive. 
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Table 4-5. (continued) 


Cannot close current extent - This error code is 
returned when BDOS cannot close the current extent prior 
to moving to the new extent containing the record 
specified by bytes r0,rl of the FCB. This error can be 
caused by an overwritten FCB or a write random operation 
on an FCB that has not been opened. 


04 (not returned by the Random Write command ) 


05 No available directory space - This condition occurs 
when the write command attempts to create a new extent 
that requires a new directory entry and no available 
directory entries exist on the selected disk drive. 


06 Random record number out of range - This error code is 
returned whenever byte r2 of the FCB is non-zero. 


Entry | Return 
Sg ee eS Be ee ee 
CL: 23H FUNCTION 35 Random Record 
Field Set 
DX: FCB COMPUTE FILE 
Offset SIZE 


When computing the size of a file, the DX register addresses an 
FCB in random mode format (bytes r0, rl, and r2 are present). The 
FCB contains an unambiguous file name which is used in the directory 
scan. Upon return, the random record bytes contain the "virtual" 
File size which is, in effect, the record address of the record 
following the end of the file. If, following a call to function 35, 
the high record byte r2 is 01, then the file contains the maximum 
record count 65536. Otherwise, bytes r0 and rl constitute a 16-bit 
value (r0 is the least significant byte, as before) which is the 
file size. 


Data can be appended to the end of an existing file by simply 
calling function 35 to set the random record position to the end of 
file, then performing a sequence of random writes starting at the 
preset record address. 


The virtual size of a file corresponds to the physical size 
when the file is written sequentially. If, instead, the file was 
created in random mode and "holes" exist in the allocation, then the 
file may in fact contain fewer records than the size indicates. If, 
for example, a single record with record number 65535 (CP/M’s 
maximum record number) is written to a file using the Write Random 
function, then the virtual size of the file is 65536 records, 
although only one block of data is actually allocated. 
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Entry Return 
AEE SENS PECL 5 SS RENN SEO ST 
CL: 24H FUNCTION 36 Random Record 
Field Set 


DX: FCB SET RANDOM 
Offset RECORD 


The Set Random Record function causes the BDOS to automatically 
produce the random record position of the next record to be accessed 
from a file which has been read or written sequentially to a 
particular point. The function can be useful in two ways. 


First, it is often necessary to initially read and scan a 
sequential file to extract the positions of various "kev" fields. 
As each key is encountered, function 36 is called to compute the 
random record position for the data corresponding to this key. If 
the data unit size is 128 bytes, the resulting record position minus 
one is placed into a table with the key for later retrieval. After 
scanning the entire file and tabularizing the keys and their record 
numbers, you can move instantly to a particular keyed record by 
performing a random read using the corresponding random record 
number which was saved earlier. The scheme is easily generalized 
when variable record lengths are involved since the program need 
only store the buffer-relative byte position along with the key and 
record number in order to find the exact starting position of the 
keyed data at a later time. | 


A second use of function 36 occurs when switching from a 
sequential read or write over to random read or write. A file is 
sequentially accessed to a particular point in the file, function 36 
is called which sets the record number, and subsequent random read 
and write operations continue from the next record in the file. 


Entry Return 
a atl ee, SEE eee EEE ae 
CL: 25H FUNCTION 37 AL: OOH 
DX: Drive RESET DRIVE 
Vector 


The Reset Drive function is used to programmatically restore 
specified drives to the reset state (a reset drive is not Logged-in 
and is in read/write status). The passed parameter in register DX 
is a 16 bit vector of drives to be reset, where the least 
significant bit corresponds to the first drive, A, and the high 
order bit corresponds to the sixteenth drive, labelled P. Bit 
values of "1" indicate that the specified drive is to be reset. 


In order to maintain compatibility with MP/M, CP/M returns a 
zero value for this function. 
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Entry Return 
EATS EEL AER SESE ETI EATS ENE SILI LEI I 
CL: 28H FUNCTION 40 AL: Return Code 
DX: FCB WRITE RANDOM 
Offset WITH ZERO FILL 


The Write Random With Zero Fill function is similar to the 
Write Random function (function 34) with the exception that a 
previously unallocated data block is initialized to records filled 
with zeros before the record is written. If this function has been 
used to create a file, records accessed by a read random operation 
that contain all zeros identify unwritten random record numbers. 
Unwritten random records in allocated data blocks of files created 
using the Write Random function contain uninitialized data. 


Entry Return 
CL: 32H FUNCTION 50 

DX: BIOS DIRECT BIOS CALL 

Descriptor 


Function 50 provides a direct BIOS call and transfers control 
through the BDOS to the BIOS. The NX register addresses a five-byte 
memory area containing the BIOS call parameters: 


8-bit 16-bit 16-bit 


value (CX) value (DX) 


where Func is a BIOS function number, (see Table 5-1), and value (CX) 
and value(DX) are the 16-bit values which would normally be passed 
directly in the CX and DX registers with the BIOS call. The CX and 
DX values are loaded into the 8086 registers before the BIOS call is 
initiated. 
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Entry Return 


UE ER TNT 


CL: 33H FUNCTION 51 


DX: Base SET DMA BASE 
Address 


Function 51 sets the base register for subsequent DMA 
transfers. The word parameter in NX is a varagraph address and is 
used with the DMA offset to specify the address of a 128 byte buffer 
area to be used in the disk read and write functions. Note that 
upon initial program loading, the default DMA base is set to the 
address of the user’s data segment (the initial value of DS) and the 
DMA offset is set to 0080H, which provides access to the default 
buffer in the base page. 


Bntrv Return 
ee a ATL SS SCL DS 
CL: 344 FUNCTION 52 BX: DMA Offset 
GET DMA BASE ES: DMA Segment 


Function 52 returns the current DMA Base Segment address in ES, 
with the current DMA Offset in DX. 


4.4 BDOS Memory Management and Load 


Memory is allocated in two distinct ways under CP/M-86. The 
first is through a static allocation map, located within the BIOS, 
that defines the physical memory which is available on the host 
system. In this way, it is possible to operate CP/M-86 in a memory 
configuration which is a mixture of up to eight non-contiguous areas 
of RAM or ROM, along with reserved, missing, or faulty memory 
regions. In a simple RAM-based system with contiguous memory, the 
static map defines a single region, usually starting at the end of 
the BIOS and extending up to the end of available memory. 


Once memory is physically mapped in this manner, CP/M-86 
performs the second level of dynamic allocation to support transient 
program loading and execution. CP/M-86 allows dynamic allocation of 
memory into, again, eight regions. A request for allocation takes 
place either implicitly, through a program load overation, Or 
explicitly through the BNOS calls given in this section. Programs 
themselves are loaded in two ways: through a command entered at the 
CCP level, or through the BDOS Program Load operation (function a9 )°% 
Multiple programs can be loaded at the CCP level, as long as each 
program executes a System Reset (function 0) and remains in memory 
(DL = 01H). Multiple programs of this type only receive control by 
intercepting interrupts, and thus under normal circumstances there 
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is only one transient program in memory at any given time. If, 
however, multiple programs are present in memory, then CONTROL-C 
characters entered by the operator delete these programs in the 
opposite order in which they were loaded no matter which vrogram is 
actively reading the console. 


Any given program loaded through a CCP command can, itself, 
load additional programs and allocate data areas. Suppose four 
regions of memory are allocated in the following order: a program 
is loaded at the CCP level through an operator command. The CMD 
file header is read, and the entire memory image consisting of the 
program and its data is loaded into region A, and execution begins. 
This program, in turn, calls the BDOS Program Load function (59) to 
load another program into region B, and transfers control to the 
loaded program. The region B program then allocates an additional 
region C, followed by a region D. The order of allocation is shown 
in Figure 4-1 below: 


Figure 4-1. Example Memory Allocation 


There is a hierarchical ownership of these regions: the program in 


A controls all memory from A through D. The program in B also 
controls regions B through D. The program in A can release regions 
B through D, if desired, and reload yet another program. ODDT-86, 
for example, operates in this manner by executing the Free Memory 
call (function 57) to release the memory used by the current program 
before loading another test program. Further, the program in B can 
release regions C and D if required by the application. It must be 
noted, however, that if either A or B terminates by a System Reset 
(BDOS function 0 with DL = 00H) then all four regions A through D 
are released. 
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A transient program may release a portion of a region, allowing 
the released portion to be assigned on the next allocation request. 
The released portion must, however, be at the beginning or end of 
the region. Suppose, for example, the program in region B ahove 
receives 800H paragraphs at paragraph location LOOH following its 
first allocation request as shown in Figure 4-2 below. 


LOOOH: 


8000H — Region C 


Figure 4-2. Example Memory Region 


Suppose further that region D is then allocated. The last 200H 
paragraphs in region C can be returned without affecting region D by 
releasing the 200H paragraphs beginning at paragraoh base 700H, 
resulting in the memory arrangement shown in Figure 4-3. 


10008: 
Length = 
6000H Region C 
Length = 7000H: | ////S/S//S//// 
2000H SIS IS SSTTSS 


Figure 4-3. Example Memory Regions 


The region beginning at paragraph address 700H is now available for 
allocation in the next request. Note that a memory request will 
fail if eight memory regions have already been allocated. Normally, 
if all program units can reside ina contiguous region, the system 
allocates only one region. 
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Memory management functions beginning at 53 reference a Memory 
Control Block (MCB), defined in the calling program, which takes the 
form: 


16-bit 16-bit 8-bit 


where M-Base and M-Length are either input or output values 
expressed in 16-byte paragraph units, and M-Ext is a returned byte 
value, as defined specifically with each function code. An error 
condition is normally flagged with a OFFH returned value in order to 
match the file error conventions of CP/M. 


Entry Return 
eae Oa a ae 
RTT Oe ee 
CL: 35H FUNCTION 53 AL: Return Code 
DX: Offset GET MAX MEM 
of MCB 


Function 53 finds the largest available memory region which is 
less than or equal to M-Length paragraphs. If successful, M-Base is 
set to the base paragraph address of the available area, and M- 
Length to the paragraph length. AL has the value OFFH upon return 
if no memory is available, and 00H if the request was successful. 
M-Ext is set to 1 if there is additional memory for allocation, and 
0 if no additional memory is available. 


FUNCTION 54 


GET ABS MAX 


Function 54 is used to find the largest possible region at the 
absolute paragraph boundary given by M-Base, for a maximum of M- 
Length paragraphs. M-Length is set to the actual length if 
Successful. AL has the value OFFH upon return if no memory is 
available- at the absolute address, and OOH if the request was 
successful. 
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Entry Return 
ae RO RENAE TTS, en eerie sate Senna 
CL: 37H '  BUNCTION 55 AL: Return Code 
DX: Offset ALLOC MEM 
of MCB 


The allocate memory function allocates a memory area according 
to the MCB addressed by DX. The allocation request size is obtained 
from M-Length. Function 55 returns in the user’s MCB the base 
paragraph address of the allocated region. Register AL contains a 
OOH if the request was successful and a OFFH if the memory could not 
be allocated. 


Return 
CLs: FUNCTION 56 AL: Return Code 


DX: | ALLOC ABS MEM 


The allocate absolute memory function allocates a memory area 
according to the MCB addressed by NX. The allocation request size 
is obtained from M-Length and the absolute base address from M-BaSe. 
Register AL contains a 00H if the request was successful and a OFFH 
if the memory could not be allocated. 


Pabey — pee | 
_ pe Ca 

CL: 39H FUNCTION 57 

DX: Offset _ FREE MEM 


of MCB 


Function 57 is used to release memory areas allocated to the 
program. The value of the M-Ext field controls the operation of 
this function: if M-Ext = OFFH then all memory areas allocated by 
the calling program are released. Otherwise, the memory area of 
length M-Length at location M-Base given in the MCB addressed by DX 
is released (the M-Ext field-should be set to OOH in this case). As 
described above, either an entire allocated region must be released, 
or the end of a region must be released: the middle section cannot 

be returned under CP/M-86. 
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Entry Return 
ee 
rs SES 
CL: 3AH FUNCTION 58 


FREE ALL MEM 


Function 58 is used to release all memory in the CP/M-86 
environment (normally used only by the CCP upon initialization). 


Entry Return 
AAS ESET ATT EE TSN 
CL: 3BH FUNCTION 59 AX: Return Code/ 
Base Page Addr 
DX: Offset PROGRAM LOAD BX: Base Page Addr 


of FCB 


Function 59 loads a CMD file. UWpon entry, register DX contains 
the DS relative offset of a successfully opened FCB which names the 
input CMD file. AX has the value OFFFFH if the program load was 
unsuccessful. Otherwise, AX and BX both contain the paragraph 
address of the base page belonging to the loaded program. The base 
address and segment length of each segment is stored in the base 
page. Note that upon program load at the CCP level, the DMA base 
address is initialized to the base page of the loaded program, and 
the DMA offset address is initialized to 0080H. However, this is a 
function of the CCP, and a function 59 does not establish a default 
DMA address. It is the responsibility of the program which executes 
function 59 to execute function 51 to set the DMA base and function 
26 to set the DMA offset before passing control to the loaded 
program. | 
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Basic 1/O System (BIOS) Organization 


The distribution version of CP/M-86 is setup for operation with 
the Intel SBC 86/12 microcomputer and an Intel 204 diskette 
controller. All hardware dependencies are, however, concentrated in 
subroutines which are collectively referred to as the Basic T/0 
System, or BIOS. A CP/M-86 system implementor can modify these 
subroutines, as described below, to tailor CP/M-86 to fit nearly any 
8086 or 8088 operating environment. This section describes the 
actions of each BIOS entry point, and defines variables and tables 
referenced within the BIOS. The discussion of Disk Definition 
Tables is, however, treated separately in the next section of this 
manual. 


5.1 Organization of the BIOS 
The BIOS portion of CP/M-86 resides in the topmost portion of 


the operating system (highest addresses), and takes the general form 
shown in Figure 5-1, below: 


CS, DS, ES, SS: 


Console 
Command 
Processor 


and 
Basic 
Disk 
Operating 
System 


| BIOS Jump Vector 


BIOS Entry Points 


CS + 2500H: 


CS + 253FH: 


BIOS: 


Disk 
Parameter 
Tables 


Uninitialized 
Scratch RAM 


Figure 5-1. General CP/M-86 Organization 
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As described in the following sections, the ccPp and BDOS are 
supplied with cp/M-86 in hex file form as CPM.H86. In order to 
imolement CP/M-86 on non-standard hardware, you must create a BIOS 
which performs the functions listed below and concatenate the 
resulting hex file to the end of the CPM.H86 file. The GENCMD 
utility is then used to produce the CPM.SYS file for subsequent load 
by the cold start loader. The cold start loader that loads the 
CPM.SYS file into memory contains a simplified form of the BIOS, 
called the LNBIOS (Loader BIOS). It loads CPM.SYS into memory at 
the location defined in the CPpM.SYS header (usually O400H). The 
procedure to follow in construction and execution of the cold start 
loader and the CP/M-86 Loader is given in a later section. 


Appendix D contains a listing of the standard cp/M-86 BIOS for 
the Intel SBC 86/12 system using the Intel 204 Controller Board. 
Appendix E shows a sample "skeletal" BIOS called CBIOS that contains 
the essential elements with the device drivers removed. You may 
wish to review these listings in order to determine the overall 
structure of the BIOS. | 


5.2 The BIOS Jump Vector 


Entry to the BIOS is through a “jump vector" located at offset 
2500H from the base of the overating system. The jump vector is a 
sequence of 21 three-byte jump instructions which transfer program 
control to the individual BIOS entry points. Although some non— 
essential BIOS subroutines may contain a single return (RET) 
instruction, the corresponding jump vector element must be present 
in the order shown below in Table 5-1l. An example of a BIOS Jump 
vector may be found in Appendix D, in the standard CP/M-86 BIOS 
Listing. ) 


Parameters for the individual subroutines in the BIOS are 
passed in the CX and DX registers, when required. CX receives the 
first parameter; DX is used for a second argument. Return values 
are passed in the registers acco ding to tyne: Byte values are 
returned in AL. Word values (16 bits) are returned in RX. Specific 
Doarameters and returned values are described with each subroutine. 
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Table 5-1. BIOS Jump Vector 


Offset from Suggested 
Beginning Instruction Description 
of BIOS 


2500H INIT 
2503H MP WBOOT 
2506H CONST 
2509H CONIN 
250CH CONOUT 
250FH } LIST 
25124 , PUNCH 
25158 . READER 
2518H HOME Move to Track 00 

251BH ) SELDSK Select Disk Drive 

251EH SETTRK Set Track Number 

2521H : SETSEC Set Sector Number 

2524H > SETDMA Set DMA Offset Address 
2527H | READ Read Selected Sector 
252AH MP WRITE Write Selected Sector 
252DH LISTST Return List Status 

2530H SECTRAN Sector Translate 

2533H SETDMAB Set DMA Segment Address 
2536H GETSEGB Get MEM DESC Table Offset 
2539H MP GETIOB Get I/O Mapping Byte 
253CH | SETIOB Set I/O Mapping Byte 


Arrive Here from Cold Boot 
Arrive Here for Warm Start 
Check for Console Char Ready 
Read Console Character In 
Write Console Character Out 
Write Listing Character Out 
Write Char to Punch Device 
Read Reader Device 


0 
1 
2 
3 
4 
5 
6 
7 
8 
9 


There are three major divisions in the BIOS jump table: system 
(re)initialization subroutines, simple character I/O. subroutines, 
and disk I/O subroutines. 


5.3 Simple Peripheral Devices 


All simple character I/O operations are assumed to be performed 
in ASCII, upper and lower case, with high order (parity bit) set to 
zero. An end-of-file condition for an input device is given by an 
ASCII control-z (1AH). Peripheral devices are seen by CP/M-86 as 
"logical" devices, and are assigned to physical devices within the 
BIOS. Device characteristics are defined in Table 5-2. 
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Table 5-2. CP/M-86 Logical Device Characteristics 


~ Device Name 


CONSOLE 


The principal interactive console which 
communicates with the operator, accessed through 
CONST, CONIN, and CONOUT. Typically, the CONSOLE 
is a device such as a CRT or Teletype. 


LIST The principal listing device, if it exists on your 
system, which is usually a hard-copy device, such 
as a printer or Teletype. 


PUNCH The principal tape punching device, if it exists, 
which is normally a high-speed paper tave ounch or 
Teletype. 


READER The pvrincival tape reading device, such as a 


simple optical reader or teletype. 


Note that a Single periohera’ can be assigned as the LIST, 
PUNCH, and READER device simultaneously. If no peripheral device is 
assigned as the LIST, PUNCH, or READER device, your CBIOS should 
give an aovropvriate error message So that the svstem does not "hang" 
if the device is accessed by PIP or some other transtent program. 
Alternately, the PUNCH and LIST subroutines can just simolyv return, 
and the READER subroutine can return with a LAH (ct1l-7%) in req A to 
indicate immediate end-of-file. 


For added flexibility, you can optionally implement, the 
"TOBYTE" function which allows reassignment of physical and logical 
devices. The IOBYTE function creates a maoping of logical to 
physical devices which can be altered during CP/M-86 processing (see 
the STAT command). The definition of the IOBYTE function 
corresponds to the Intel standard as follows: a single location in 
the BIOS is maintained, called TOBYTE, which defines the logical to 
physical device mapping which is in effect at a particular time. 
The mapping is performed by splitting the IOBYTE into four distinct 
fields of two bits each, called the CONSOLE, READER, PUNCH, and LIST 
fields, as shown below: | 


most significant least significant 


PUNCH READER CONSOLE 


bits 6,7 bits 4,5 bits 2,3 bits 0,1 


IOBYTE 


All Information Presented Here is Proprietary to Digital Research 


58 


CP/M-86 System Guide 5.3 Simple Peripheral Devices 


The value in each field can be in the range 0-3, defining the 
assigned source or destination of each logical device. The values 
which can be assigned to each field are given in Table 5-3, below. 


Table 5-3. IOBYTE Field Definitions 


CONSOLE field (bits 0,1) 


console is assigned to the console printer (TTY:) 

console is assigned to the CRT device (CRT:) 

batch mode: use the READER as the CONSOLE input, 

and the LIST device as the CONSOLE output (BAT:) 
- user defined console device (UC1:) 


field (bits 2,3) 

- READER is the Teletype device (TTY:) 

- READER is the high-speed reader device (RDR:) 
- user defined reader # 1 (URI1:) 

- user defined reader # 2 (UR2:) 


PUNCH field (bits 4,5) 
0 - PUNCH is the Teletype device (TTY:) 
1 - PUNCH is the high speed punch device (PUN:) 
2 - user defined vunch # 1 (UPI1:) 
3 - user defined vounch # 2 (UP2:) 


LIST field (bits 6,7) 
0 - LIST is the Teletype device (TTY:). 
1 - LIST is the CRT device (CRT:) 
2 - LIST is the line printer device (LPT:) 
3 - user defined list device (ULI1:) 


Note again that the implementation of the IOBYTE is optional, 
and affects only the organization of your CBIOS. No CP/M-86 
utilities use the IOBYTE except for PIP which allows access to the 
physical devices, and STAT which allows logical-physical assignments 
to be made and displayed. In any case, you should omit the IOBYTE 
implementation until your basic CBIOS is fully implemented and 
tested, then add the IOBYTE to increase your facilities. 
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5.4 BIOS Subroutine Entry Points 


The actions which must take place upon entrv to each BIOS 
subroutine are given below. It should be noted that disk I/O is 
always performed through a sequence of calls on the various (1isk 
access subroutines. These setup the disk number to access, the 
track and sector on a particular disk, and the direct memory access 
(DMA) offset and seqment addresses involved in the 1/0 operation. 
After all these parameters have been setupbd, a call is made to the 
READ or WRITE function to verform the actual I/O operation. Note 
that there is often a single call to SELDSK to select a disk drive, 
followed by a number of read or write onerations to the selected 
disk before selecting another drive for subsequent operations. 
Similarly, there may be a call to set the DMA seqment base and a 
call to set the DMA offset followed by several calls which read or 
write from the selected DMA address before the DMA address iS 
changed. The track and sector Subroutines are always called before 
the READ or WRITE overations are performed. 


The READ and WRITE subroutines should perform several retries 
(10 is standard) before reporting the error condition to the BDOS. 
The HOME subroutine mav or may not actually perform the track 00 
seek, depending upon your controller characteristics; the imvoortant 
point is that track 00 has been Selected for the next oneration, and 
is often treated in exactly the same manner as SETTRK with a 
parameter of 00. 


Table 5-4. BIOS Subroutine Summary 


INIT This subroutine is called directly by the CP/M-86 
loader after the CPM.SYS file has been read into 
memory. The procedure is responsible for anv 
hardware initialization not verformed by the 
bootstrap loader, setting initial values for 8310S 
variables (including IOBYTE), printing a sign-on 
message, and initializing the interrupt vector to 
point to the BDOS offset (OB11H) and base. When 
this routine comvletes, it jumps to the CCP 
offset (0H). All segment registers should be 
initialized at this time to contain the base of 
the operating system. 


This subroutine is called whenever a program 
terminates by performing a BDOS function #1) call. 
Some re-initialization of the hardware or 
software may occur here. When this routine 
completes, it jumps directly to the warm start 
entry point of the CCP (06H). 


Sample the status of the currently assigned 
console device and return OFFH in register AL if 
a character is ready to read, and 00H in register 
AI, if no console characters are ready. 
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Table 5-4. (cont inued) 


CONIN Read the next console character into register AL, 
and set the parity bit (high order bit) to zero. 
If no console character is ready, wait until a 
character is typed before returning. 


CONOUT Send the character from register CL to the 
console output device. The character is in 
ASCII, with high order parity bit set to zero. 
You may want to include a time-out on a line feed 
Or carriage return, if your console device 
requires some time interval at the end of the 
line (such as a TI Silent 700 terminal). You 
can, if you wish, filter out control characters 
which have undesirable effects on the console 
device. 


LIST Send. the character from register CL to the 
currently assigned listing device. The character 
is in ASCII with zero. parity. 


PUNCH Send the character from register CL to the 
Currently assigned punch device. The character 
is in ASCII with zero parity. 


READER Read the next character from the currently 
assigned reader device into register AL with zero 
parity (high order bit must be zero). An end of 
file condition is reported by returning an ASCII 
CONTROL-Z (1AH). 


HOME Return the disk head of the currently selected 
disk to the track 00 position. If your 
controller does not have a special feature for 
finding track 00, you can translate the call into 
a call to SETTRK with a parameter of 0. 
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Table 5-4. (continued) 


SELDSK Select the disk drive given by register CL for 
further operations, where register CL contains 0 
for drive A, 1 for drive B, and so on up to 15 
for drive P (the standard CP/M-86 distribution 
version supports two drives). On each disk 
select, SELDSK must return in BX the base address 
of the selected drive’s Nisk Parameter Header. 
For standard floppy disk drives, the content of 
the header and associated tables does not change. 
The sample BIOS included with CP/M-86 called 
CBIOS contains an example program segment that 
performs the SELDSK function. If there is an 
attempt to select a non-existent drive, SELDSK 
returns BX=0000H as an error indicator. Although 
SELDSK must return the header address on each 
call, it is advisable to postpone the actual 
physical disk select overation until an I/9 
function (seek, read or write) is verformed. 
This is due to the fact that disk select 
operations may take vlace without a subsequent 
disk operation and thus disk access may he 
substantially slower using some disk controllers. 
On entry to SELDSK it is vossible to determine 
whether it is the first time the specified disk 
has been selected. Register NL, bit O (least 
significant bit) is a zero if the drive has not 
been previously selected. This information is of 
interest in systems which read configuration 
information from the disk in order to set upd a 
dynamic disk definition table. 


SETTRK Register CX contains the track number for 
subsequent disk accesses on the currently 
selected drive. You can choose to seek the 
selected track at this time, or delay the seek 
until the next read or write actually occurs. 
Register CX can take on values in the range 0-76 
corresponding to valid track numbers for standard 
floopy disk drives, and 0- 65535 for non-standard 
disk subsystems. 


SETSEC Register CX contains the translated sector number 
for subsequent disk accesses on the currently 
selected drive (see SECTRAN, below). You can 
choose to send this information to the controller 
at this point, or instead delay sector selection 
until. a read or write operation occurs. 
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Table 5-4. (continued) 


SETDMA Register CX contains the DMA (disk memory access) 
offset for subsequent read or write operations. 
For example, if CX = 80H when SETDMA is called, 
then all subsequent read operations read their > 
data into 80H through OFFH offset from the 
Current DMA segment base, and all subsequent 
write operations get their data from that 
address, until the next calls to SETDMA and 
SETDMAB occur. Note that the controller need not 
actually support direct memory access. If, for 
example, all data is received and sent through 
I/O ports, the CBIOS which you construct will use 
the 128 byte area starting at the selected DMA 
offset and base for the memory buffer during the 
following read or write operations. 


READ Assuming the drive has been selected, the track 
has been set, the sector has been set, and the 
DMA offset and segment base have been specified, 
the READ subroutine attempts to read one sector 
based upon these parameters, and returns the 
following error codes in register AL: 


0 no errors occurred 
1 non-recoverable error condition occurred 


Currently, CP/M-86 responds only to a zero or 
non-zero value as the return code. That is, if 
the value in register AL is 0 then CP/M-86 
assumes that the disk operation completed 
properly. If an error occurs, however, the CBIOS 
should attempt at least 10 retries to see if the 
error is recoverable. When an error is reported 
the BDOS will print the message "BDOS ERR ON x: 
BAD SECTOR". The operator then has the option of 
typing RETURN to ignore the error, or CONTROL-C 
to abort. 


WRITE Write the data from the currently selected DMA 
buffer to the currently selected drive, track, 
and sector. The data should be marked as "non- 
deleted data" to maintain compatibility with 
other CP/M systems. The error codes given in the 
READ command are returned in register AL, with 
error recovery attempts as described above. 


LISTST Return the ready status of the list device. The 
value 00 is returned in AL if the list device is 
not ready to accept a character, and OFFH if a 
character can be sent to the printer. 
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Table 5-4. (continued) 


SECTRAN Performs logical to physical sector translation 
to improve the overall response of CP/M-86. 
Standard CP/M-86 systems are shipped with a "skew 
factor" of 6, where five physical sectors are 
skipped between sequential read or write 
operations. This skew factor allows enough time 
between sectors for most programs to load their 
buffers without missing the next sector. Tn 
computer systems that use fast processors, memory 
and disk subsystems, the skew factor may be 
changed to improve overall response. Note, 
however, that you should maintain a single 
density IBM compatible version of CP/M-86 for 
information transfer into and out of your 
computer system, uSing a skew factor of 6. In 
general, SECTRAN receives a logical sector number 
in CX. This logical sector number may range from 
0 to the number of sectors -l. Sectran also 
receives a translate table offset in DX. The 
sector number is used as an index into the 
translate table, with the resulting physical 
sector number in BX. For standard systems, the 
tables and indexing code is orovided in the CBIOS 
and need not be changed. Tf DX = OOOOH no 
translation takes place, and CX is simply copied 
to BX before returning. Otherwise, SECTRAN 
computes and returns the translated sector number 
in BX. Note that SECTRAN is called when no 
translation is specified in the Disk Parameter 
Header. 


SETDMAB Register CX contains the segment base for 
subsequent DMA read or write operations. The 
BIOS will use the 128 byte buffer at the memory 
address determined by the DMA base and the DMA 
offset during read and write operations. 


GETSEGB Returns the address of the Memory Region Table 
(MRT) in BX. The returned value is the offset of 
the table relative to the start of the operating 
system. The table defines the location and 
extent of physical memory which is available for 
transient programs. | 
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Table 5-4. (continued) 


Memory areas reserved for interrupt vectors and 
the CP/M-86 operating system are not included in 
the MRT. The Memory Region Table takes the form: 


8-bit 


ee ee 


where R-Cnt is the number of Memory Region 
Descriptors (equal to n+l in the diagram above), 
while R-Base and R-Length give the paragraph base 
and length of each physically contiguous area of 
memory. Again, the reserved interrupt locations, 
normally 0-3FFH, and the CP/M-86 operating system 
are not included in this map, because the mav 
contains regions available to transient programs. 
If all memory is contiguous, the R-Cnt field is l 
and n = 0O, with only a single Memory Region 
Descriptor which defines the region. 


GETIOB Returns the current value of the logical to 
physical input/output device byte (IOBYTE). in AL. 
This eight-bit value is used to associate 
physical devices with CP/M-86°s four logical. 
devices. 


SETIOB Use the value in CL to set the value of the 
IOBYTE stored in the BIOS. 


The following section describes the exact layout and 
construction of the disk parameter tables referenced by various 
subroutines in the BIOS. 
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BIOS Disk Definition Tables 


Similar to CP/M-80, CP/M-86 is a table-driven operating system 
with a separate field- -configurable Basic TI/0O System (BIOS). By 
altering svecific subroutines in the BIOS presented in the previous 
section, CP/M-86 can be customized for operation on any RAM-based 
8086 or 3088 microvorocessor svstem. 


The purpose of this section is to present the organization and 
construction of tables within the BIOS that define the 
characteristics of a particular disk system used with CP/M-86. 
These tables can be either hand-coded or automatically generated 
using the GENNEF utilitv provided with CP/M-86. The elements of 
these tables are presented below. 


6.1 Disk Parameter Table Format 


In general, each disk drive has an associated (16-byte) disk 
parameter header which both contains information about the disk 
drive and vrovides a scratchvoad area for certain BNOS operations. 
The format of the disk parameter header for each drive is shown 
below. 


where each element is a word (16-bit) value. The meaning of each 
Disk Parameter Header (NPH) element is given in Table 6-l. 


Table 6-1. Disk Parameter. Header Elements 


XLT Offset of the logical to physical translation vector, 
if used for this particular drive, or the value 0000H 
if no sector translation takes place (i.e, the 
vhysical and logical sector numbers are the same). 
Nisk drives with identical sector skew factors share 

the same translate tables. 


Scratchpad values for use within the BNOS 
value is unimportant). 


(initial 
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Table 6-l. (continued) 


DIRBUF Offset of a 128 byte scratchpad area for directory 
operations within BDOS. All NPH“s address the same 
scratchpad area. 


DPB Offset of a disk parameter block for this drive. 
Drives with identical disk characteristics address the 
same disk parameter block. 


Offset of a scratchvad area used for software check for 
changed disks.. This offset is different for each NP#H. 


Offset of a scratchvoad area used by the BDOS to keeo 
disk storage allocation information. This offset is 
different for each DPH. 


Given n disk drives, the DPH’s are arranged in a table whose first 
row of 16 bytes corresponds to drive 0, with the last row 
corresponding to drive n-l. The table thus appears as 


DPBASE 


(and so-forth through) 


where the label DPBASE defines the offset of the DNPH table relative 
to the beginning of the operating system. | . 


A responsibility of the SELDSK subroutine, defined in the 
previous section, is to return the offset of the NPH from the 
beginning of the overating system for the selected drive. The 
following sequence of operations returns the table offset, with a 
OOOOH returned if the selected drive does not exist. | 
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NDISKS  EOQU 4 :NUMBER OF DISK DRIVES 
SELDSK: | 

>SELECT DISK N GIVEN BY CL 

MOV BX,0000H :READY FOR ERR 

CPM CL,NDISKS ;N BEYOND MAX DISKS? 


JNB RETURN *RETURN IF SO 
<0 <= N < NDISKS 

MOV CH,0 *DOUBLE (N) 

MOV BX ,CX “BX = N 

MOV CL, 4 sREADY FOR * 16 

SHL BX ,CL “N= N * 16 

MOV CX,OFFSET NPBASE 

ADD BX ,CX *DPBASE +N * 16 
RETURN: RET ;BX - .DPH (N) 


The translation vectors (XLT 00 through XLTn-1) are located 
elsewhere in the BIOS, and simply correspond one-for-one with the 
logical sector numbers zero through the sector count-l. The Disk 
Parameter Block (DPB) for each drive is more complex. A particular 
DPB, which is addressed by one or more DPH’s, takes the general 
Form: 


M LO 
16b 8b 8b 8b  } ¥ 16b 16b 8b 8b 


16b 16b — 


where each is a byte or word value, as shown by the "8b" or "16b" 
indicator below the field. The fields are defined in Table 6-2. 


Table 6-2. Disk Parameter Block Fields 
is the total number of sectors per track 


is the data allocation block shift factor, determined 
by the data block allocation size. 


is the block mask which is also determined by the data 
block allocation size. 


is the extent mask, determined by the data block 
allocation size and the number of disk blocks. 


determines the total storage capacity of the disk drive 


determines the total number of directory entries which 
can be stored on this drive 
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Table 6-2. (continued) 


ALO,ALL determine reserved Adirectorv blocks. 


cKS is the size of the directory check vector 


OFF is the number of reserved tracks at the beginning of 
the (logical) disk. 


Although these table values are produced automatically by GENDEF, it 
is worthwhile reviewing the derivation of each field so that the 
values may be cross-checked when necessary. The values of BSH and 
BLM determine (implicitly) the data allocation size BLS, which is 
not an entry in the disk parameter block. Given that you have 
selected a value for BLS, the values of BSH and BLM are shown in 
Table 6-3 below, where all values are in decimal. 


Table 6-3. BSH and BLM Values for Selected BLS 


1,024 
2,048 


4,096 
8,192 
16,384 


The value of EXM depends upon both the BLS and whether the DSM value 


is less than 256 or greater than 255, as shown in the following 
table. | 


Table 6-4. Maximum EXM Values 


DsM_> 255 


The value of DSM is the maximum data block number supported by 
this particular drive, measured in BLS units. The product BLS times 
(DSM+1) is the total number of bytes held by the drive and, of 
course, must be within the capacity of the physical disk, not 
counting the reserved operating system tracks. 
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The DRM entry is one less than the total number of directory 
entries, which can take on a 16-bit value. The values of ALO and 
AL1, however, are determined by DRM. The two values ALO and ALl can 
together be considered a string of 16-bits, as shown below. 


00 OL 02 03 04 05 06 07 08 09 10 11 12 13 14 15 


where position 00 corresponds to the high order bit of the byte 
labeled ALO, and 15 corresponds to the low order bit of the byte 
labeled AL1. Each bit position reserves a data block for a number 
of directory entries, thus allowing a total of 16 data blocks to he 
assigned for directory entries (bits are assigned starting at 00 and 
filled to the right until vosition 15). Bach directory entrv 
occupies 32 bytes, as shown in Table 6-5. 


Table 6-5. BLS and Number of Directory Entries 


Directorv Entries 


Thus, if DRM = 127 (128 directory entries), and BLS = 1024, then 
there are 32 directory entries per block, requiring 4 reserved 
blocks. In this case, the 4 high order bits of ALO are set, 
resulting in the values ALO = OFOH and AL1 = OOH. 


The CKS value is determined as follows: if the disk drive 
media is removable, then CKS = (DRM+1)/4, where DRM is the last 
directory entry number. If the media is fixed, then set CKS = 0 (no 
directory records are checked in this case). | 


Finally, the OFF field determines the number of tracks which 
are skipped at the beginning of the physical disk. This value is 
automatically added whenever SETTRK 1s called, and can be used as a 
mechanism for skipping reserved operating system tracks, or for 
partitioning a large disk into smaller ‘segmented sections. 


To complete the discussion of the DPB, recall that several 
DPH’s can address the same DPB if their drive characteristics are 
identical. Further, the DPB can be dynamically changed when a new 
drive is addressed by simply changing the pointer in the NPH since 
the BDOS copies the DPB values to a local area whenever the SELDSK 
function is invoked. 
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Returning back to the NPH for a particular drive, note that the 
two address values CSV and ALV remain. Both addresses reference an 
area of uninitialized memory following the BIOS. The areas must be 
unique for each drive, and the size of each area is determined by 
the values in the NPB. 


The size of the area addressed by CSV is CKS bytes, which is 
sufficient to hold the directory check information for this 
particular drive. If CKS = (DRM+1)/4, then you must reserve 
(DRM+1)/4 bytes for directory check use. If cKS = 0, then no 
storage is reserved. 


The size of the area addressed by ALV is determined by the 
maximum number of data blocks allowed for this particular disk, and 
is computed as (NSM/8)+1. 


The BIOS shown in Appendix D demonstrates an instance of these 
tables for standard 8" single density drives. [It may be useful to 
examine this program, and compare the tabular values with the 
definitions given above. 


6.2 Table Generation Using GENDEF 


The GENDEF utility supplied with CP/M-86 greatly simplifies the 
table construction process. GENDEF reads a file 


xX .DEF 


containing the disk definition statements, and vroduces an output 
file , | 


x. LIB 


containing assembly language statements which define the tables 


necessary to support a particular drive configuration. The form of © 


the GENDEF command is: 
GENDEF. x parameter list 
where x has an assumed (and unspecified) filetype of DEF. The 


parameter list may contain zero or more of the symbols defined in 


Table 6-6. GENDEF Optional Parameters 


SC Generate Disk Parameter Comments 
Te) Generate DPBASE OFFSET $ 
$Z 780, 8080, 8085 Override 


(Any of the Above) 
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The C parameter causes GENDEF to produce an accompanying 
comment line, similar to the output from the "STAT DSK:" utility 
which describes the characteristics of each defined disk. Normally, 
the DPBASE is defined as 


DPBASE EQU $ 


which requires a MOV CX,OFFSET DPBASE in the SELDSK subroutine shown 
above. For convenience, the $O parameter produces the definition 


DPBASE EQU OFFSET $ 


allowing a MOV CX,DPBASE in SELDSK, in order to match your 
particular programming practices. The $Z parameter is included to 
override the standard 8086/8088 mode in order to generate tables 
acceptable for operation with 730, 8080, and 8085 assemblers. 


The disk definition contained within x.DEF is composed with the 
CP/M text editor, .and consists of disk definition statements 
identical to those accepted by the DISKDEF macro supplied with CP/M- 


80 Version 2. A BIOS disk definition consists of the following 
sequence of statements: 


DISKS n 
DISKDEF 0,... 
DISKDEF 1,... 
DISKNEF n-l 


ENDEF 


Each statement is placed on a single line, with optional embedded | 
comments between the keywords, numbers, and delimiters. 


The DISKS statement defines the number of drives to be 
configured with your system, where n is an integer in the range l 
through 16. A series of DISKDEF statements then follow which define 
the characteristics of each logical disk, 0 through n-l, 
corresponding to logical drives A through P. Note that the DISKS 
and DISKDEF statements generate the in-line fixed data tables 
described in the previous section, and thus must be placed in a non- 


executable portion of your BIOS, typically at the end of your BIOS, 
before the start of uninitialized RAM. 


The ENDEF (End of Diskdef) statement generates the necessary 


uninitialized RAM areas which are located beyond initialized RAM in 
your BIOS. 


All Information Presented Here is Proprietary to Digital Research 


73 


CP/M-86 System Guide 6.2 Table Generation Using GENDEF 


The form of the DISKDEF statement is 


DISKDEF dn,fsc,lsc,[(skf]1,b1s,dks,dir,cks,ofs, [0] 


where 
dn is the logical disk number, 0 to n-l 
fse is the first vhvsical sector number (0 or 1) 
lsc is the last sector number 
skf is the optional sector skew factor 
bls is the data allocation block size 
dks is the disk size in bJs units 
dir is the number of directory entries 
cks is the number of "checked" directory entries 
ofs is the track offset to logical track 00 
[0] is an optional 1.4 compatibility flag 


The value "dn" is the drive number being defined with this DISKNEF 
statement. The "fsc" parameter accounts for differing sector 
numbering systems, and is usually 0 or 1. The "Isc" is the last 
numbered sector on a track. When present, the "skf€" parameter 
defines the sector skew factor which is used to create a sector 
translation table according to the skew. If the number of sectors 
is less than 256, a sSingle-byte table is created, otherwise each 
translation table element occupies two bytes. No translation table 
is created if the sk€ parameter is omitted or equal to 0. 


The "bls" parameter specifies the number of bytes allocated to 
each data block, and takes on the values 1024, 2048, 4096, 8192, or 
16384. Generally, verformance increases with larger data block 
sizes because there are fewer directory references. Also, logically 
connected data records are physically close on the disk. Further, 
each directory entry addresses more data and the amount of BIOS work 
Space is reduced. The "dks" specifies the total disk size in "bls" 
units. That is, if the bls = 2048 and dks = 1000, then the total 
disk capacity is 2,048,000 bytes. If dks is greater than 255, then 
the block size parameter bls must be greater than 1024. The value 
of "dir" is the total number of directory entries which may exceed 
255, if desired. 


The "cks" parameter determines the number of directory items to 
check on each directory scan, and is used internally to detect 
changed disks during system operation, where an intervening cold 
start or system reset has not occurred (when this situation is 
detected, CP/M-86 automatically marks the disk read/only so that 
data is not subsequently destroved). As stated in the previous 
section, the value of cks = dir when the media is easily changed, as 
is the case with a floppy disk subsystem. Tf the disk is 
permanently mounted, then the value of cks is typically 0, since the 
probability of changing disks without a restart is quite low. 
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The "“ofs" value determines the number of tracks to skip when 
this particular drive is addressed, which can be used to reserve 
additional operating system space or to simulate several. logical 
drives on a single large capacity physical drive. Finally, the [0] 
parameter is included when file compatibility is required with 
versions of CP/M-80, version 1.4 which have been modified for higher 
density disks (typically double density). This varameter ensures 
that no directory compression takes place, which would cause 
incompatibilities with these non-standard CP/M 1.4 versions. 
Normallv, this varameter is not included. 


For convenience and economy of table space, the special form 
DISKDEF i, 


gives disk i the same characteristics as a oreviously defined drive 
4. Astandard four-drive single density system, which is compatible 
with CP/M-80 Version 1.4, and upwardly compatible with CP/M-80 
Version 2 implementations, 1s defined using the following 
statements: 


DISKS 4 
DISKNEF 0 1,26,6,1024,243,64,64,2 
DISKDEF 1 

NISKDEF 2 
DISKDEF 3 


ENDEF 


with all disks having the same parameter values of 26 sectors per 
track (numbered 1 through 26), with a skew of 6 between sequential. 
accesses, 1024 bytes per data block, 243 data blocks for a total of 
243K byte disk capacity, 64 checked directory entries, and two 
operating system tracks. 


The DISKS statement generates n Disk Parameter Headers (DPH*s), 
starting at the DPH table address NPBASE generated by the statement. 
Fach disk header block contains sixteen bytes, as described above, 
and corresponds one-for-one to each of the defined drives. In the 


four drive standard system, for example, the DISKS statement 
generates a table of the form: 


DPBASE EQU $ | 

DPEO DW XLTO , 0000H, 0000H, 0000H, DIRBUF , DPBO,CSV0,ALVO 
DPE1 DW XLTO ,0000H,0000H, 0000H, DIRBUF ,DPBO,CSV1,ALV1 
DPE2 DW XLTO ,0000H, 0000H, 0000H, DIRBUF , DPB0 ,CSV2,ALV2 
DPE3 DW XLTO ,0000H,0000H, 0000H, DIRBUF ,DPBO ,CSV3,ALV3 


where the DPH labels are included for reference purposes to show the 
beginning table addresses for each drive 0 through 3. The values 
contained within the disk parameter header are described in detail 
earlier in this section. The check and allocation vector addresses 
are generated by the ENDEF statement for inclusion in the RAM area 
following the BIOS code and tables. 
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Note that if the "skf" (skew factor) parameter is omitted (or 
equal to 0), the translation table is omitted, and a 0000H value is 
inserted in the XLT vosition of the disk parameter header for the 
disk. In a subsequent call to verform the Logical to vohysical 
translation, SECTRAN receives a translation table address of DX = 
OOOOH, and simply returns the original logical sector from CX in the 
BX register. A translate table is constructed when the skf 
parameter iS voresent, and the (non-zero) table address is volaced 
into the corresponding DPH“s. The table shown below, for example, 
1S constructed when the standard skew factor skf = 6 is svecified in 
the DISKDEF statement call: 


XLTO EQU OFFSET S 
DB Lgl pL 35197 257k e3 orp hoy eek 
NB 2,8,14,20,26,6,12,18,24,4,10,16, 22 


Following the ENDEF statement, a number of uninitialized data 
areas are defined. These data areas need not be a part of the BIOS 
which is loaded upon cold start, but must be available between the 
BIOS and the end of operating system memory. The size of the 
uninitialized RAM area is determined by EOQU statements generated by 
the ENDEF statement. For a standard four-drive system, the ENDEF 
statement might produce 


1¢c72° = BEGNAT EOU OFFSET S 
(data areas) 
LDBO = ENDNAT EONU OFFSET S$ 
013¢c = DATSIZ EOU OFFSET S-REGDAT 


which indicates that uninitialized RAM begins at offset 1C72H, ends 
at 1LDBOH-1, and occupies O13CH bytes. Vou must ensure that these 
addresses are free for use after the system is loaded. 


After modification, you can use the STAT vrogram to check your 
drive characteristics, since STAT uses the disk varameter block to 
decode the drive information. The comment included in the LIB file 
by the SC parameter to GENCMND will match the output from STAT. The 
STAT command form 


STAT d:DSK: 


decodes the disk parameter block for drive d (d=A,...,) and 
displays the values shown below: 


128 Byte Record Capacity 
Kilobyte Drive Capacity 
32 Byte Directory Entries 
Checked Directory Entries 
Records/ Extent 

Records/ Block 

Sectors/ Track 

Reserved Tracks 


cH eon aan 
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6.3 GENDEF Output 


GENDEF produces a listing of the statements included in the DEF 
file at the user console (CONTROL-P can be used to obtain a printed 
listing, if desired). Each source line is numbered, and any errors 

are shown below the line in error, with a "?" beneath the item which 
caused the condition. The source errors produced by GENCMD are 
listed in Table 6-7, followed by errors that can occur when 
producing input and output files in Table 6-8. 


Table 6-7. GENDEF Source Error Messages 


Bad Val More than 16 disks defined in DISKS statement. 


Convert Number cannot be converted, must be constant 
in binary, octal, decimal, or hexadecimal as 
in ASM-86. 

Delimit. Missing delimiter between parameters. 

Nuplic Duplicate definition for a disk drive. 

Extra Extra parameters occur at the end of line. 

Length Keyword or data item is too lond. 

Missing Parameter required in this position. 

No Disk Referenced disk not previously defined. 

No Stmt Statement keyword not recognized. 

Numeric Number required in this position 

Range Number in this position is out of range. 

Too Few Not enough parameters provided. 


Quote Missing end quote on current line. 
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Table 6-8. GENDEF Input and Output Error Messages 


Cannot Close ".LIB" File LIB file close operation 
unsuccessful, usually due 
to hardware write protect. 


"LIB" Disk Full No space for LIB file. 


No Input File Present Specified DEF file not 
found. 


No ".LIB" Directory Space Cannot create LIB file due 
to too manv files on LIB 
disk. 


Premature End-of-File End of DEF file encountered 
unexpectedly. 


Given the file TWO.NEF containing the following statements 
disks 2 
diskdef 0,1,26,6,2048,256,128,128,2 
diskdef 1,1,58,,2048,1024,300,0,2 
endef 
the command 
gencmd two Sc 


produces the console output 


DISKDEF Table Generator, Vers 1.0 


1 DISKS 2 

2 DISKDEF 0,1,58,,2048,256,128,128,2 
3 DISKDEF 1,1,58,,2048,1024,300,0,2 
4 ENDEF 


No Error(s) 


The resulting TWO.LIB file is brought into the following skeletal 
assembly language program, using the ASM-86 INCLUDE directive. The 
ASM-86 output listing is truncated. on the right, but can be easily 
reproduced using GENDEF and ASM-86. 
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Sample Program Including TWO.LI 


SELDSK: 

0000 BI 03 00 MOV CX,OFFSET NPBASE 
= 0003 dpbase equ $ | sBase O 
= 0003 32 00 00 00 dped dw x1t0,0000h eTransl 
= 0007 00 00 00 OO dw 0000h,0000h eScratc 
= 000B 5B 00 23 00 dw dirbuf ,dpb0 eNir Bu 
= 000F FB 00 DB O00 dw csv0,alv0 eCheck, 
= 0013 00 00 00 00 dpel Aw x1t1lL,0000h eTransl. 
= 0017 00 00 00 OO dw 0000h,0000h sScratc 
= 001B 5B 00 4c 00 dw Airbuf ,dobl eNir Bu 
= OO1F 9B Ol 1B Ol dw csvl, alvl eCheck, 
= : DISKDEF 0,1,26,6,2048,2 
- : Nisk 0 is CP/M 1.4 Sinale Nensi 
= ° 4096: 128 Byte Record Capacit 
= : 512: Kilobyte Prive Capacit 
= : 128: 32 Byte Directory Entri 
= 7 128: Checked Directory Entri 
= ° 256: Records / Extent 
= : 16: Records / Block 
= ° 26: Sectors / Track 
= . 2: Reserved Tracks 
= : 6: Sector Skew Factor 
= 0023 dpb0d equ offset $ sNisk P. 
= 0023 1A 00 dw 26 Sector 
= 0025 04 | ab 4 «Block 
= 0026 OF db 15 *Block 
= 0027 OL ab 1 eRxtnt 
= 0028 FF 00 dw 255 eDisk S 
= 002A 7F 00 dw 127 eDirect 
= 002cC CO db 192 *AllocO 
= 002D 00 oho) 0 eAllocl 
= 002F 20 00 dw 32 *Check 
= 0030 02 00 dw 2 Offset 
= 0032 x1t0 equ offset §$ sTransl 
= 0032 OL 07 OD 13 db 15 7713,19 
= 0036 19 05 OB ll db 25,5,11,17 
= 003A 17 03 09 OF db 23,379,715 
= 003E 15 02 08 OE db 21,2,8,14 
= 0042 14 1A 06 OC db 20,26,6,12 
= 0046 12 18 04 OA db 18,24,4,10 
= 004A 10°16 db 16,22 
= 0020 als0O equ 32 sAlloca 
= 0020 css0 equ 32 eCheck 
= A DISKDEF 1,1,58,,2048,10 
= ; Disk 1 is CP/M 1.4 Single Nensi 
= . 16384: 128 Byte Record Canacit 
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2048: Kilobyte Nrive Capacit 
300: 32 Byte Nirectory Fntri 
0: Checked Nirectoryv Entri 
128: Records / Fxtent | 
16: Records / Block 
58: Sectors / Track 
2: Reserved Tracks 


en ~™e ~e we ~O VE VH VSH VE 


= 004C pol equ offset S sNisk P 
= 004C 3A 00 dw 58 Sector 
= O04EF 04 db 4 >Block 
= O004F OF db 15 e-Block 
= 0050 00 db 0 eExtnt 
= 0051 FF 03 dw 1023 sNisk S 
= 0053 2B Ol dw 299 eNirect 
= 0055 F8 db 248 eAllocO 
= 0056 00 db 0 sAllocl 
= 0057 00 O00 dw 0 eCheck 
= 0059 02 OOD dw 2 sNftset 
= 0000 xiLtl equ 0 sNo Tra 
= 0080 alsl equ 128 sAlloca 
= 0000 cssl equ 0 eCheck 
= : ENDEF 

= : Uninitialized Scratch Memory Fo 
= 005B begdat equ offset $ eStart 
= 005B dirbuf rs 128 eNirect 
= QODB alvO rs als0 eAlloc 
= OOFB csv0 rs css0 eCheck 
= 011B alvl rs alsl eAlloc 
= 019B . csvl rs cssl eCheck 
= 0198 enddat equ offset S$ sFnd of 
= 0140 datsiz equ offset S$-beqdat ;Size o 
= 019B 00 db 0 «Marks 

END 
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CP/M-86 Bootstrap and Adaption Procedures 


This section describes the components of the standard CP/M-86 
distribution disk, the operation of each component, and the 
procedures to follow in adapting CP/M-86 to non-standard hardware. 


CP/M-86 is distributed on a sinaqle-density IBM compatible g" 
diskette using a file format which is compatible with all previous 
CP/M-80 operating systems. In particular, the first two tracks are 
reserved for operating system and bootstrap programs, while the 
remainder of the diskette contains directory information which Leads 
to program and data files. CP/M-86 is distributed for operation 
with the Intel SBC 86/12 single-board computer connected to flovopy 
disks through an Intel 204 Controller. The operation of CP/M-86 on 
this configuration serves aS a model for other 8086 and 8088 
environments, and is presented below. 


The principal components of the distribution system are Listed 
below: 


@ The 86/12 Bootstrap ROM (BOOT ROM) 
@ The Cold Start Loader (LOANER) 
@® The CP/M-86 System (CPM.SYS) 


When installed in the SBC 86/12, the BOOT ROM becomes a Dart of 
the memory address space, beginning at bvte location OFFOOOH, and 
receives control when the system reset button is depressed. Ina 
non-standard environment, the BOOT ROM is replaced by an equivalent 
initial loader and, therefore, the ROM itself is not included with 
CP/M-86. The BOOT ROM can be obtained from Digital Research or, 
alternatively, it can be programmed from the listing given in 
Appendix C or directly from the source file which is included on the 
distribution disk as BOOT.A86. The responsibility of the BOOT ROM 
is to read the LOADER from the first two system tracks into memory 
and pass vrogram control to the LOADER for execution. 


7.1 The Cold Start Load Operation 


The LOADER program is a simple version of CP/M-86 that contains 
sufficient file processing capability to read CPM.SYS from the 
system disk to memory. When LOADER completes its operation, the 
CPM.SYS program receives control and proceeds to process operator 
input commands. 


Both the LOADER and CPM.SYS programs are preceded by the 
standard CMD header record. The 128-byte LOADER header record 
contains the following single group descriptor. 
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8b 16b | 16b 16b 16b 


1 


where G-Form = 1 denotes a code group, "x" fields are ignored, and 
A-Base defines the paragraph address where the BOOT ROM begins 
filling memory (A-Base is the word value which is offset three bytes 
from the beginning of the header). Note that since only a code 
group is present, an 8080 memory model is assumed. Further, 
although the A-Base defines the base paragravh address for LOADER 
(byte address 04000H), the LOADER can, in fact be loaded and 
executed at any paragraph boundary that does not overlapv CP/M-86 or 
the BOOT ROM. 


The LOADER itself consists of three parts: the Load CPM 
program (LDCPM), the Loader Basic Nisk System (LDBDOS), and the 
Loader Basic I/O System (LDBIOS). Although the LOADER is setup to 
initialize CP/M-86 using the Intel 86/12 configuration, the LDBIOS 
can be field-altered to account for non-standard hardware using the 
Same entry points described in a previous section for BIOS 
modification. The organization of LOADER is shown in Figure 7-1 
below: 


GD#1 0 SSSSSS/SSS//S// 


CS DS ES SS OOOOH: 


JMPF CPM 


(LDBDOS ) 


0400H: 


JMP INIT 


1200H: 


JMP SETIOB 


INIT: .. JMP 0003H 
(LDBIOS) 
1700H: 


Figure 7-]. LOADER Organization 


All Information Presented Here is Proprietary to Digital Research 


82 


CP/M-86 System Guide 7.1 The Cold Start Load Operation 


Byte offsets from the base registers are shown at the left of the 
diagram. GD#1 is the Group Descriptor for the LOADER code group 
described above, followed immediately by a "0" group terminator. 
The entire LOADER program is read by the BOOT ROM, excluding the 
header record, starting at byte location 04000H as given by the A- 
Field. Upon completion of the read, the BOOT ROM passes control to 
location 04000H where the LOADER program commences execution. The 
JMP 1200H instruction at the base of LDCPM transfers control to the 
beginning of the LDBIOS where control then transfers to the INIT 
subroutine. The subroutine starting at INIT performs device 
initialization, prints a sign-on message, and transfers back to the 
LDCPM program at byte offset 0003H. The LDCPM module opens the 
CPM.SYS file, loads the CP/M-86 system into memory and transfers 
control to CP/M-86 through the JMPF CPM instruction at the end of 
LDCPM execution, thus completing the cold start sequence. 


The files LDCPM.H86 and LDBDOS.H86 are included with CP/M-86 so 
that you can append your own modified LDBIOS in the construction of 
a customized loader. In fact, BIOS.A86 contains a conditional 
assembly switch, called "loader bios," which, when enabled, produces 
the distributed LDBIOS. The INIT subroutine portion of LDBIOS is 
listed in Appendix C for reference purposes. To construct a custom 
LDBIOS, modify your standard BIOS to start the code at offset 1200H, 
and change your initialization subroutine beginning at INIT to 
perform disk and device initialization. Include a JMP to offset 
0003H at the end of your INIT subroutine. Use ASM-86 to assemble 
your LDBIOS.A86 program: 


ASM86 LDBIOS 


to produce the LDBIOS.H86 machine code file. Concatenate the three 
LOADER modules using PIP: 


PIP LOADER. H86=LDCPM.H86,LDBNOS.H86, LDBIOS.H86 


to produce the machine code file for the LOADER program. Although 
the standard LOADER program ends at offset 1700H, your modified 
LDBIOS may differ from this last address with the restriction that 
the LOADER must fit within the first two tracks and not overlap 


CP/M-86 areas. Generate the command (CMD) file for LOADER using the 
GENCMD utility: : 


GENCMN LOADER 8080 CODE[A400] 


resulting in the file LOADER.CMD with a header record defining the 
8080 Memory Model with an absolute paragraph address of 400H, or 
byte address 4000H. Use DDT to read LOADER.CMD to location 900H in 
your 8080 system. Then use the 8080 utility SYSGEN to copy the 
loader to the first two tracks of a disk. 
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A>DDT 

- ILOADER.CMD 

-R800 

-“C 

A>SYSGEN 

SOURCE DRIVE NAME (or return to skip) <cr> 
DESTINATION DRIVE NAME (or return to skip) B 


Alternatively, if you have access to an operational CP/M-86 system, 
the command 


LDCOPY LOADER 


copies LOADER to the system tracks. You now have a diskette with a 
LOADER program which incorporates your custom LDBIOS capable of 
reading the CPM.SYS file into memory. For standardization, we 
assume LOADER executes at location 40008. LOADER is sStaticallv 
relocatable, however, and its operating address is determined only 
by the value of A-Base in the header record. 


You must, of course, perform the same function as the BOOT ROM 
to get LOADER into memory. The boot operation is usually 
accomplished in one of two ways. First, you can program your own 
ROM (or PROM) to perform a function similar to the BOOT ROM when 
your computer*’s reset button is pushed. As an alternative, most 
controllers provide a power-on "boot" operation that reads the first 
disk sector into memory. This one-sector program, in turn, reads 
the LOADER from the remaining sectors and transfers to LOADER upon 
completion, thereby performing the same actions as the BOOT ROM. 
Either of these alternatives is hardware-specific, so you’ 11 need to 
be familiar with the operating environment. 


7.2 Organization of CPM.SYS 
The CPM.SYS file, read by the LOADER program, consists of the 


CCP, BDOS, and BIOS in CMD file format, with a 128-byte header 
record similar to the LOADER program: 


16b 16b 16b 16b 


where, instead, the A-Base load address is paragraph 040H, or byte 
address 0400H, immediately following the 8086 interrupt locations. 
The entire CPM.SYS file appears on disk as shown in Figure 7-2. 


All Information Presented Here is Proprietary to Digital Research 


84 


Cp/M-86 System Guide 7.2 Organization of CPM.SYS 


fepet O/////IIILIT/ 


(0040:0) CS DS ES SS O000H: 


(CCP and BDOS) 


(0040:) 2500H: JMP INIT 


JMP SETIOB 


(BIOS) 


INIT: .. JMP OOOOH 
(0040:) 2A00H: 


Figure 7-2. CPM.SYS File Organization 


where GD#l1 is the Group Descriptor containing the A-Base value 
followed by a "0" terminator. The distributed 86/12 BIOS is listed 
in Appendix D, with an "include" statement that reads the 
SINGLES.LIB file containing the disk definition tables. The 
SINGLES.LIB file is created by GENDEF using the SINGLES.DEF 
statements shown below: 


disks 2 

diskdef 0,1,26,6,1024,243,64,64,2 
diskdef 1,0 | 

endef 


The CPM.SYS file is read by the LOADER program beginning at the 
address given by A-Base (byte address 0400H), and control is passed 
to the INIT entry point at offset address 2500H. Any additional 
initialization, not performed by LOADER, takes place in the INIT 
subroutine and, upon completion, INIT executes a JMP 0000H to begin. 
execution of the CCP. The actual load address of CPM.SYS is 
determined entirely by the address given in the A-Base field which 
can be changed if you wish to execute CP/M-86 in another region of 
memory. Note that the region occupied by the operating system must 
be excluded from the BIOS memory region table. 


Similar to the LOADER program, you can modify the BIOS by 
altering either the BIOS.A86 or skeletal CBIOS.A86 assembly language 
files which are included on your source disk. In either case, 
create a customized BIOS which includes your specialized I/O 
drivers, and assemble using ASM-86: 


ASM86 BIOS 


to produce the file BIOS.H86 containing your BIOS machine code. 
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Concetenete this new BIOS to the CPM.H8S file on your distribution 
disk: 


PIP CPMX.H86 = CPM.H86,BI0S.H85 


The resulting CPMX hex file is then converted to CMD file fotmet by 
executing 


GENCMD CPMX 8080 CODE [A40] 


in order to produce the CMD memory imege with A-Base = 40H. 
Finally, rename the CPMX file using the command 


REN CPM.SYS = CPMX.CMD 


and place this file on your 8086 system disk. Now the tailoring 
process is complete: you have replaced the BOOT ROM by either your 
own customized BOOT ROM, or a one-Sector cold start loader which 
brings the LOADER program, with your custom LDBIOS, into memory at 
byte location 04000H. The LOADER program, in turn, reads the 
CPM.SYS file, with your custom BIOS, into memory at byte location 
O400H. Control transfers to CP/M-85, and you are up and operating. 
CP/M-86 remains in memory until the next cold start operation takes 
plece. 


You can avoid the two-step boot operation if you construct a 
non-stendard disk with sufficient space to hold the entire CPM.SYS 
file on the system tracks. In this case, the cold start brings the 
CP/M-86 memory image into memory at the location given by A-Base, 
and control transfers to the INIT entry point at offset 2500H. 
Thus, the intermediate LOADER program is eliminated entirely, 
although the initialization found in the LDBIOS must, of course, 
take place instead within the BIOS. 


Since ASM-86, GENCMD and GENDEF are provided in both COM and 
CMD formats, either CP/M-80 or CP/M-86 can be used to aid the 
customizing process. If CP/M-80 or CP/M-86 is not available, but 
you have minimal editing and debugging tools, you can write 
specialized disk I/O routines to read and write the system tracks, 
as well as the CPM.SYS file. 


The two system trecks are simple to access, but the CPM.SYS 
file is somewhat more difficult to read. CPM.SYS is the first file 
on the disk and thus it appears immediately following the directory 
on the diskette. The directory begins on the third track, and 
occupies the first sixteen logical sectors of the diskette, while 
the CPM.SYS is found starting at the seventeenth sector. Sectors 
are "skewed" by a factor of six beginning with the directory track 
(the system tracks are sequential), so that you must load every 
sixth sector in reading the CPM.SYS file. Clearly, it is worth the 
time end effort to use an existing CP/M system to aid the conversion 
process. 
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Appendix A 
Sector Blocking and Deblocking 


Upon each call to the BIOS WRITE entry point, the CP/M-86 BDOS 
includes information that allows effective sector blocking and 


deblocking where the host disk subsystem has a sector size which is 
a multiple of the basic 128-byte unit. This appendix vresents a 
general-purpose alaorithm that can be included within your BIOS and 
that uses the BDOS information to perform the overations 
automaticallv. 


Tpon each call to WRITE, the BNOS vrovides the following 
information in register CL: 


normal sector write 
write to directory sector 
= write to the first sector 
of a new data block 


Nr oO 
MI 


Condition 0 occurs whenever the next write overation is into a 
previously written area, such as a random mode record update, when 
the write is to other than the first sector of an unallocated block, 
or when the write is not into the Airectorv area. Condition 1 
occurs when a write into the directory area is performed. Condition 
2 occurs when the first record (only) of a newlv allocated data 
block is written. In most cases, avplication programs read or write 
multipole 128-bvte sectors in sequence, and thus there is little 
overhead involve4 in either overation when blocking and deblocking 
records since wore-read operations can be avoided when writing 
records. ae | 


This aopendix lists the blocking and deblocking algorithm in 
skeletal form (the file is included on vour CP/M-86 disk). 
Generally, the algorithms map all. cp/M sector read operations onto 
the host disk through an intermediate buffer which is the size of 
the host disk sector. Throughout the program, values and variables 
which relate to the CP/M sector involved in a seek operation are 
prefixed by "sek," while those related to the host disk svstem are 
orefixed by "hst." The equate statements beginning on line 24 of 
Appendix F define the mapping between CP/M and the host system, and 
must be changed if other than the sample host svstem is involved. 


The SELDSK entry voint clears the host buffer flag whenever a 
new disk is logged-in. Note that although the SELDSK entry point 
computes and returns the Nisk Parameter Header address, it does not 
ohysically select the host disk at this point (it is selected later 
at READHST or WRITEWST). Further, SETTRK, SETSEC, and SETDMA simvdlv 
store the values, but do not take any other action at this point. 
SECTRAN performs a trivial function of returning the physical sector 
number. 
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The principal entry points are READ and WRITE. These. 


Subroutines take the place of your previous READ and WRITE 
operations. | 


The actual physical read or write takes place at either 
WRITEHST or READHST, where all values have been prepared: hstdsk is 
the host disk number, hsttrk is the host track number, and hstsec is 
the host sector number (which mav require translation to a physical 
Sector number). You must insert code at this point which performs 
the full host sector read or write into, or out of, the buffer at 
hstbuf of length hstsiz. All other mapping functions are performed 
by the algorithms. 


FRI ITI I I RR TTI I HR II II RI IIHR KR IIR ERR RRR ER ELE 


o* Sector Blocking / Neblocking 


e@ e0@ ee e686 


>* This algorithm is a direct transl].ation of the 

-* CPp/M-80 Version, and is included here for refer- 
s* ence purposes only. The file DERLOCK.LIB is in- 
-* cluded on your CP/M-86 disk, and should be used 
>* for actual applications. You may wish to contact 
-* Digital Research for notices of updates. 


OUD IHRUP WNP 


+ + % + + F HF HF HF OF 


SH KH HK HHH IH IKI KEK IKKE KEKE KEE EEEREKEKEEKEEREEEESE 


Je HI KK HHH RIKI HII II RHEE KIKI KEKE KEKE EEERKKKKKKE KEKE 


CP/M to host disk constants * 


ee 06 86 e8@ €0@ 86 86 06 ee e@ ee 00 e8@ 06 @ 


on nU & WN PF 


(This example is setup for CP/M block size of 16K * 
with a host sector size of 512 bytes, and 12 sec- * 
tors per track. BlksiZ, hstsiz, hstspt, hstblk * 
and secshf may change for different hardware.) * 
fete He de HHH HHI KKK KEI KEE KERR ERK EKER RKKEEE 


equ byte ptr [BX] ename for byte at BX 


e@ ~e tO MO tO TO NO TO MO TE NE SN 
+ + ee ee FH FF 


WJ 
e Ce 

He 

0) 


5: blksiz equ 16384 *CP/M allocation size 

6: hstsiz equ 512 shost disk sector size 
7: hstspt equ “12 shost disk sectors/trk 
8: hstblk equ hstsiz/128 sCP/M sects/host buff 

Oe 4 


Oe 0 FI II I IT I TIO II IKI I RTI IK RI HHH RRR ERE R ERE REE ES 


31: ;* = 
32: ;* secshf is log2(hstblk), and is listed below for * 
33: :* values of hstsiz up to 2048. : * 
34: ;* * 
35: 3* hstsiz hstblk secshf * 
36: ;:* 256 2 1 * 
37: ;3* 512 4 2 * 
38: 3* 1024 8 3 * 
393° 3% 2048 16 4 * 
40; ;* te 
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BAI II III III IIIT TI II I II II II HIRI IIR IR EEE EEE 


secshf equ 2 
cpmspt equ 
secmsk equ 


hstblk-1 


hstblk * hstspt 


slog2 (hstbl1.k) 
-CP/M sectors/track 
esector mask 


’ 
FI IIIT IIIT TOI I RIOR TR ITT IIR II IIR IH IR III IRR IR ERE ES 


ox * 
e ; 
ial BNDOS constants on entry to write * 
oX * 
. 4 

6 FI III I RTI TOR I III TI I I ITI KTR III KIKI KITA ER ERE EE EES 
wrall equ 0 swrite to allocated 
wrdir equ 1 swrite to directory 
wrual equ 2 ewrite to unallocated 


IIR II RHR II RRR I IK IIR IKI IRE IR IIR RRR IKE ER ERR EEE RES 


oX * 
v 

al The BIOS entry points given below show the * 
i code which is relevant to dehlocking only. ” 
o* * 


oI TTR III I IR III TI RIK IRR IKI AIH IIHR EERE REE EEE EEE SE 


seldsk: 
sselect disk 


eis this the first activation of the drive? 


test DL,l 
jnz selset 


elsb = 0? 


ethis is the first activation, clear host buff 


mov hstact,0 
mov unacnt,0 
selset: 
mov al,cl ! cbw 
mov sekdsk,al 
mov cl,4 ! shi. al,cl. 
add ax,offset dpbase 
mov bx,ax 


eput in AX 


eseek disk number 
etimes 16 


echeck for pending write 


sclear host active flag 


snow, set track zero 


etrack to seek 


ret 
? 
home: 
shome the sel].ected disk 
mov al,hstwrt 
test al,al 
inz homed 
mov hstact,0 
homed : 
mov cx,0 
° (continue HOME routine) 
ret 
settrk: 
eset track given by registers CX 
mov sektrk,Cx 
ret 
setsec; 


sset sector given by register cl 


mov seksec,cl 


esector to seek 
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96: ret 
Ot -4 
98: setdma: 
99; eset dma address given by ©X 
100: mov dma off ,Cx 
101: ret 
LOZ: 2 
103: setdmab: 
104: eset segment address given by CX 
105; mov dma seg,CxX 
106: ret ~ 
107: ; 
108: sectran: 
109: stranslate sector number CX with table at [NX] 
110: test NX,DX stest for hard skewed | 
111: jz notran >(blocked must be hard skewed) 
112: mov BX,CX 
113: add BX,NX 
114: mov BL, [BX] 
115: ret 
116: no trans: 
117: - shard skewed disk, vhysical = logical sector 
118: mov BX,CX 
119: ret 
1203 3 
121: read: 
122:  gread the selected CP/M sector 
123: mov unacnt,0 sclear unallocated counter 
124: mov readop,l sread opveration 
125: mov rsflag,l emust read data 
126: mov wrtype,wrual etreat as unaljoc 
127: imp rwoper sto perform the read 
128: ; 
129: write: 
130: ewrite the selected CP/M sector 
131: mov readop,0 swrite opneration 
132% mov wrtype,cl 
133: cmp cl] ,wrual ewrite unallocated? 
134: jnz chkuna : scheck for unal.loc 
135: ; 
1363: ; write to unallocated, set parameters. 
137452 
138: moy unacnt, (blksiz/128) ;next unaJjloc recs 
139: mov al,sekdsk sdisk to seek 
140: mov unadsk,al eunadsk = sekdsk 
141: mov ax,sektrk 
142: mov unatrk,ax sunatrk = sektrk 
143: mov al,seksec 
144: mov unasec,al eunasec = seksec 
145: 3 
146: chkuna: 
147: scheck for write to unallocated sector 
148: ; 
149; mov bx,offset unacnt spoint "UNA" at UNACNT 
150: mov al,una ! test al,al ;any unalloc remain? 
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151: jz alloc eskip if not 

1523.3 

£533 <¢ more unallocated records remain 

154: dec al eunacnt = unacnt-l 
155: mov una,al 

156: mov al,sekdsk sesame disk? 

157: mov Bx,offset unadsk 

158: cmp al,una ssekdsk = unadsk? 

159; jnz alloc eskip if not 

160: ; 

161: ; disks are the same 

162: mov AX, unatrk 

163: cmp AX, sektrk 

164: jnz alloc eskip if not 

165: 3 

166: ; tracks are the same 

167: mov al,seksec Same sector? 

168: ; 

169: mov BX,offset unasec spoint una at unasec 
170: ; LS oe 

L7 is cmp al,una sseksec = unasec? 

172: jnz alloc sskip if not 

L733; 3 

174: 3; match, move to next sector for future ref 

175: inc una eunasec = unasectl 
1763 mov al,una eend of track? 

177: cmp al,cpmspt scount CP/M sectors 
178: jb noovf eskio if below 

179: ; 

180: ; overflow to next track 

1813; mov una,0 eunasec = 0 

182: inc unatrk seunatrk=unatrk+l 

1833: ; | 

184: noovf: 

1853 ematch found, mark as unnecessary read 

186: mov rsflag,0 ersflag = 0 | 
187: jmps rwoper eto perform the write 
188: ; 

189: alloc: 

190: snot an unallocated record, requires pre-read 
191: mov unacnt,9 eunacnt = 0 

192: mov rsflag,l ersflag = l 

193: edrop through to rwoper 
194: ; 

195: IEICE GI IIS IGISIIGIIIIISIIOIITITITIDIIIIIOIT III IIIT I 
196: ;* * 
197: ;:* Common code for READ and WRITE follows * 
198: ;* * 


199: FI RI TOI TOTO II II IIIT TI III IIIA III IR ER ER EE EES 
200: rwoper: 


201; senter here to perform the read/write 

2023: mov erflag,0 eno errors (yet) 
203: mov al, seksec ecompute host sector 
204: mov el, secshf 

2053 shr al,cl 
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206: 
207: 
208: 
209: 
210: 
211: 
212: 
213: 
214: 
215; 
216: 
217: 
218: 
219: 
220: 
221: 
222: 
223: 
224: 
22532 
226: 
2273 
228: 
2293 
230: 
231: 
232: 
233: 
234: 
235; 


2363. 


237: 
238: 
239: 
240: 
241: 
242: 
243: 
244: 
245; 
246: 
247: 
248: 
249: 
250: 
251: 
252: 
2533 
254: 
255: 
256: 
2573 
258: 
259: 
2603 


~All 


-=eq 86 


—e Oe 


=e BO 


=e ZO 


nomatch: 


? 
filhst: 


e 
a 


filhstl: 


match: 


mov sekhst,al ehost sector to seek 


active host sector? 


mov al,l 

xchg al,hstact salways becomes 1 
test al,al ewas it already? 
jz filhst efill host if not 


host buffer active, same as seek buffer? 
mov al,sekdsk 

cmp al,hstdsk esekdsk = hstdsk? 
inz nomatch 


same disk, same track? 

mov ax,hsttrk 

cmp ax,sektrk shost track same as seek track 
inz nomatch 


same disk, same track, same buffer? 

mov al,sekhst 

cmp al.,hstsec esekhst = hstsec? 
4zZ match eskip if match 


eproper disk, but not correct sector 
mov al, hstwrt 


test al,al e"djirtv" buffer ? 
jz filhst eno, don’t need to write 
call writehst eyes, clear host buff 


(check errors here) 


emav have to fill the host buffer 
mov al,sekdsk ! mov hstdsk,al. 

mov ax,sektrk ! mov hsttrk,ax 

mov al,sekhst ! mov hstsec,al. 

mov al,rsflag 


test al,al sneed to read? 
iz filhstl 

call readhst eyes, if l 
(check errors here) 


mov hstwrt,0 eno pending write 


ecopy data to or from buffer depending on "readop" 


‘mov al,seksec emask buffer number 


=e 


=e 20 


and ax,secmsk eleast signif bits are masked 
mov cl, 7 ! shl ax,cl eshift left 7 (* 128 = 2**7) 


ax has relative host buffer offset 


add ax,offset hstbuf eax has buffer address 
mov si,ax sput in source index register 
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261: 
262: 
2633 
264: 
265: 
266: 
267: 
268: 
269: 
270: 
271: 
272: 
2733 
274: 
275: 
276: 
277: 


278: 


2793 
280: 
281: 
282: 
283: 
284: 
2853 
286: 
287: 
288: 
289: 
290: 
291: 
292: 
293: 
294: 
295: 
296: 
297: 
2983 
299: 
300: 
301: 
302: 
303: 
304: 
305: 
306: 
307: 
308: 
309: 
310: 
311: 
312: 
313? 
314: 
315: 


All 
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mov di,dma_off euser buffer is dest if readop 
push DS ! push ES ssave seqment registers 
mov ES,dma_seg eset destseg to the users seg 
sSI/DI and DS/ES is swapped 
eif write op 
mov cx,128/2 slength of move in words 
mov al,readop 
test al,al ewhich way? 
jnz rwmove sskip if read 
H write operation, mark and switch direction 
mov hstwrt,l | ehstwrt = 1 (dirty buffer now) 
xchg si,di ssource/dest index swap 
mov ax,NS 
mov ES,ax 
mov DS,dma_seg esetup NS,ES for write 
e 
rwmove: | ; 
cld ! rep movs AX,AX smove as 16 bit words 
pop ES ! pop DS erestore segment registers 
: data has been moved to/from host buffer 
cmp wrtype,wrdir ewrite type to directorv? 
mov al,erflag ein case of errors 
jnz return_rw eno further processing 
: clear host buffer for directory write 
test al,al serrors? 
jnz return_rw ;skip if so 
mov hstwrt,0 ebuffer written 
call writehst 
mov al,erflag 
return_rw: 


ret 
’ 
ACO ICICI III TOTTORI I IITA R IRE IE TEES 
rh * 
e* WRITEHST performs the physical write to the host * 
°* disk, while REANHST reads the physical disk. * 
o* | * 
tf 
RII HIRI I IH HRI IIR RII RK IKK RIKER EERE ERE REE EES 


writehst: 


e 
f 


readhst: 


=e ZO VE WE WO VEO 
e+ + ee F 


ret 


ret 


He Ke He Ke He KR KIKKKKRRRKKEKKERRKKKEREEKKKKERKKKRRKEKEKKEKE 


* 


Use the GENDEF utility to create disk def tables * 
* 


Je de He He He HHH II III IIR AKI RRR KEE REKR EEE R EE RHEEREEKEEEEKEES 


equ offset $ 
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316: ; disk varameter tables go here 

317: ; 

318-2 oA HH I I II HH HRITHIK HHI RRR IIHR EERE RRR EERE SEES 
319: ;* = 
320: :* Uninitialized RAM areas follow, including the * 
321: :* areas created by the GENDFF utility listed above. * 
S223 3% | - 
323: oH KH RRR KK RRR RIK IKKE RHE REE ERE REE RRR ERE ERS 
324: sek_dsk rb 1 sseek disk number 

325: sek _trk rw 1 ;seek track number 
326: sek_sec rb 1 ;seek sector number 
S212. 3 

328: hst_dsk rb 1 shost disk number 

329: hst_trk rw 1 ehost track number 
330: hst_sec rb 1 shost sector number 
331: ; 

332: sek_hst rb 1 sseek shr secshf 

333: hst_act rb 1 shost active flag 

334: hst_wrt rb lL shost written flag 
335: : 

336: una_cnt rb 1 sunalloc rec cnt 

337: una_dsk rb 1 ;last unalloc disk 
338: una_trk rw 1 slast unalloc track 
339: una_sec rb 1 ;Last unalloc sector 
340: ; 

341: erflag rb L serror revorting 

342: rsflag rb 1 eread sector flag 

343: readop rb 1 el if read operation 
344: wrtvpe rb 1 ewrite operation tyve 
345: dma_seg rw 1 slast dma seqment 

346: dma_off rw 1 slast dma offset 

347: hstbuf rb hstsiz shost buffer 

348: end 
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- Appendix B 
Sample Random Access Program 


This appendix contains a rather extensive and comolete example 
of random access operation. The program listed here verforms the 
simple function of reading or writing random records upon command 
from the terminal. Given that the program has been created, 
assembled, and placed into a file labelled RANDOM.CMN, the CCP Jevel 
command: 


RANDOM X.DAT 


Starts the test program. The vorogram looks for a file by the name 
X.DAT (in this voarticular case) and, if found, proceeds to prompt 
the console for inout. If not found, the File is created before the 
prompt is given. Fach prompt takes the form 


next command? 


and is followed by operator input, terminated by a Carriage return. 
The inout commands take the form 


nw nR 0) 


where n is an. integer value in the range 9 to 65535, and W, R, and O 
are simple command characters corresponding to random write, random 
read, and quit processing, resvectively. If the W command is 
issued, the RANDOM program issues the promot 


type data: 


The operator then responds by tvping up to 127 characters, followed 
by a carriage return. RANDOM then writes the character string into 
the X.NAT file at record n. If the R command is issued, RANDOM 
reads record number n and displays the string value at the console. 
If the Q command is issued, the X.DAT file is closed, and the 
program returns to the console command vrocessor. The only error 
message 1S 


error, try again 


The program begins with an initialization section where the 
input file is opened or created, followed by a continuous loop at 
the label "ready" where the individual commands are interovreted. 
The default file control block at offset 005CH and the default 
buffer at offset 0080H are used in all disk operations. The utilitv 
Subroutines then follow, which contain the principal input line 
processor, called "“readc." This particular vrogram shows the 
elements of random access processing, and can be used as the basis 
for further program development. In fact, with some work, this 
program could evolve into a simole data base management svstem. 
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One could, for example, assume a standard record size of 128 
bytes, consisting of arbitrary Fields within the record. A Drogqram, 
called GETKEY, could be developed which first reads a secuential 
file and extracts a svecific field defined bv the operator. For 
example, the command 


GETKEY NAMES.DAT LASTNAME 10 20 


would cause GETKEY to read the data base file NAMES.NDAT and extract 
the "LASTNAME" field from each record, starting at position 10 and 
ending at character 20. GETKRY builds a table in memory consisting 
of each particular LASTNAME field, along with its 16-bit record 
number location within the file. The GETKEY program then sorts this 
list, and writes a new file, called LASTNAME.KEY, which is an 
alphabetical list of LASTNAME fields with their corresponding record 
numbers. (This list is called an "inverted index" in information 
retrieval parlance.) 


Rename the program shown above as ONERY, and enhance it a bit 
so that it reads a sorted key file into memory. The command Line 
might appear as: 


QUBRY NAMES.NAT LASTNAME. KEY 


Instead of reading a number, the OUERY program reads an alphanumeric 
string which is a particular key to find in the NAMES.DAT data base. 
Since the LASTNAME.KEY List is sorted, vou can find a particular 
entry quite rapidly by performing a "binary search," similar to 
looking up a name in the telephone book. That is, starting at both 
ends of the list, you examine the entry halfway in between and, if 
not matched, split either the uvper half or the lower half for the 
next search. You’1ll quickly reach the item you’re looking for (in 
log2(n) stevos) where you’ll find the corresponding record number. 
Fetch and display this record at the console, just as we have done 
in the vrogram shown above. 


At this point you’re just getting started. With a little more 
work, you can allow a fixed grouping size which differs from the 128 
byte record shown above. This is accomplished by keeping track of 
the record number as well as the byte offset within the record. 
Knowing the group size, you randomly access the record containing 
the proper grouv, offset to the beginning of the group within the 
record read sequentially until the group size has been exhausted. 


Finally, you can improve QUERY considerably by allowing boolean 
expressions which compute the set of records which satisfy several. 
relationships, such as a LASTNAME between HARDY and LAUREL, and an 
AGE less than 45. Display all the records which fit this 
description. Finally, if your lists are getting too big to fit into 
memory, randomly access your key files from the disk as well. 
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- 


a 
NH OW ADAINHUAWN-H 


be 
eS) 


=e @6@ ~O ~e TO VO TWH NWS VO 


coninp equ 
conout equ 
pstring equ 
rstring equ 
version equ 
openf equ 


closef equ 
_makef equ 


readr equ 
writer equ 


tf 


° Fauates for 
equ 
equ 


=—Q 
chr 


=e se Se NO; 


cseg 
pushf 
pov 
cli 
mov 
MOV 
mov 
push 
popf 


=e =O BOE BO WO 


mov 
call 
cmp 
jnb 


e 
f 


mov 
call 
jmp 


t] 


versok: 

: correct 
Mov 
Mov 
call 
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See I II HI HII IK RII II IKI KK KKK IR IKK KEIR EK EEEEER 
* * 
* Sample Random Access Program for CP /M-86 * 
* * 
* 


Je de IK HI IK I IIH KKK KI IKI KKK II KERR ERK KEE RE EEKRERE 


BDOS Functions 


1 econsole input function 
2 sconsole output function 
9 sprint string until *s$* 
10 sread console buffer 

12 ereturn version number 
L5 efile oven function 

L6 eclose function 

22 emake file function 

33 eread random 

34 ewrite random 


non graphic characters 
Odh ecarriage return 
Oah eline feed 


load SP, ready file for random access 


soush flaqs in CCP stack 


ax | esave flags in AX 
edisable interrupts 

bx ,ds eset SS register to base 

ss,bx eset SS, SP with interru 

so, ,offset stack ; for 80888 

ax erestore the flags 


CP/M-86 initial release returns the File 
system version number of 2.2: check is 
shown below for illustration purposes. 


cl,version 

bdos | 

al,20h sversion 2.0 or later? 
versok 

bad version, message and go back 

dx, offset badver 

print 

abort 


version for random access 
cl,openf - sopen default fect 
dx offset fcb 

bdos 
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56: 
57:3 
58: 
59: 
60: 
61: 
62:3 
63: 
64: 
65: 
66: 
67: 
68: 
69: 
70: 
71: 
72: 
73: 
74: 
753 
76: 
773 
78: 
79: 
80: 
81: 
82: 
83: 
84: 
85: 
86: 
87s: 
88: 
89: 
90: 
91: 
92: 
93: 


94: . 


95: 
96: 
97: 
98: 
99: 
100: 
101: 
102: 
103: 
104: 
105: 
106: 
107: 
108: 
109: 
110: 


All 


me BO 


=e EO 


eady: 


mo wo FE ee tO we 


=e 0 


otqd: 


we TJ we we we we NO 


=e €0 


rloop: 


inc 
jnz 


Appendix B Random Access Sample Program 


al eerr 255 becomes zero 
ready | 


cannot open file, so create it 


mov 
mov 
call 
inc. 
inz 


cl ,makef 

dx ,offset fcb 

bdos 

al eerr 255 becomes zero 
ready 


cannot create file, directory full 


mov 


call 


imp 


dx ,offset nospace 
print 


abort sback to ccp 


loop back to “ready” after each command 


file is ready for processing 


call 
MOV 
mov 
cmp 
jnz 


readcom sread next command 
ranrec,dx estore input record# 
ranovf,0Oh eclear high byte if set 
al.,“O° equit? 

notq 


quit processing, close file 


mov 
mov 
call 
inc 
jz 
Jmps 


end of quit command, 


cl1,closef 
dx offset fcb 


bdos 

al serr 255 becomes 0 
error eerror message, retry 
abort eback to ccp 


process write 


not the quit command, random write? 


cmp 
inz 


this is 


mov 
call 
Mov 
Mov 


al,°w 
notw 


a random write, fill buffer until cr 
dx offset datmsg 
print 

cx, 127 

bx ,offset buff 


sdata prompt 
eup to 127 characters 
edestination 


eread next character to buff 


push 
push 
call 
pop 
poo 
cmp 


cx esave loop conntrol. 
bx enext destination 
getchr echaracter to AL 

bx erestore destination 
cx srestore counter 
al,cr eend of line? 
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1il: jz er loop 

112: 3; not end, store character 

113: MOV byte ptr [bx],al 

114: inc bx enext to fill 
115: loop t loop sdecrement cx ../|00p if 
116: erloop: | 

117: : end of read loop, store 00 

118: MOV byte ptr [bx] ,0h 

119: ; 

120: ; write the record to selected record number 
121; mOv cl,writer 

122: mov dx ,offset fcb 

123: call bdos 

124; or al,al eerror code zero? 
125: Zz ready efor another record 

126: jmps error smessage if not 

IZ: 3 

1283: ; 

129: ; 

130: : end of write command, process read 

131: ; 

132: 2 

133: notws | 

134: ; not a write command, read record? 

135: cmp al,°R* 

136: jz ranread 

137: jmps error eskip if not 

138: ; : 

1393: ; read random record 

140: ranread: 

141: mov cl,readr 

142: MOv dx ,offset fcb 

1433 call bdos 

144: Or al,al ereturn code 00? 
145: jz readok 

146: jmps error 

147: ; 

148: ; read was successful, write to console 
149: readok: 

150: call crlf enew line | 

151: Mov cx, 128 emax 128 characters 
152: mov si,offset buff ;next to get 

153: wloop: | 

154: lods al enext character 
155; and al,07fh emask parity 

156: inz wloopl 

157: jmp ready efor another command if 
158: wloopl: 

159: push cx esave counter 
160: push si esave next to get 
161: cmp al," egraphic? 

162: jb skipw eskip output if not grap 
163: call putchr soutput character 
164: skipw: 

165: pop si 
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166: 
167: 
168: 
169: 
170: 
L713: 
172: 
173: 
174: 
175: 
176: 
177: 
178: 
179: 
180: 
181: 
182: 
183: 
184: 
185: 
186: 
187: 
188: 
189: 
190: 
191: 
192: 
193: 
194: 
195: 
196: 
197: 
198: 
199: 
200: 
201: 
202: 
203: 
204: 
205: 
206: 
207: 
208: 
209: 
210: 
211: 
212: 
2133 
214: 
215: 
216: 
217: 
218: 
219: 
220: 


All 


(D ~e ~e ~e re se 


rrors: 


O =e ~e 
Qu 
O 
n 


abort: 


etchr: 


OQ we ~e ~e 


, 
putchr: 


crifs: 


print: 


C 


readcom: 


pop Cx 
loop wloop edecrement CX and check 
imp ready 


end of read command, all errors end-up here 


mov dx ,offset errmsg 
call print 
Imp ready 


entry subroutine 


int 224 sentry to BNOS if by INT 
ret 


ereturn to CCP 
mov c1,0 
call bdos euse function 0 to end e 


utility subroutines for console i/o 


eread next console character to a 


mov cL,conino 
call bdos 
ret 


swrite character from a to console 


mov cl.,conout 

Mov dl,al echaracter to send 
call bdos esend character 
ret 


esend carriage return line feed 


mov al,cr ecarriage return 
call putchr 

MOv al,lf sline feed 

call putchr 

ret 


sprint the buffer addressed by dx until § 
push dx 
call crif 


pop ax snew line 

MOV cl,pstring 

call bdos eprint the string 
ret 
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221: 
222: 
223: 
224: 
2253 
226: 
227: 
228: 
229: 
230: 
231: 
232: 
233: 
234: 
235: 
236: 
237: 
238: 
239: 
240: 
241: 
242: 
243: 
244: 
245: 
246: 
247: 
248: 
249: 
250: 
251: 
2523 
253: 
254: 
255: 
256: 
257: 
2583 
259: 
260: 
2613 
262: 
263: 
264: 
265: 
266: 
267: 
268: 
269: 
270: 
271: 
272: 
273: 
274: 
2152 


All 


Appendix B Random Access Sample Program 


eread the next command line to the conbuf 
MOv dx, offset promot : 
call print ecommand? 
mov cl,rstring 
mov dx,offset conbuf 
call bdos eread command line 
; command line is present, scan it 
mov ~ ax,0 estart with 0000 
MOV bx ,offset conlin 
readc: mov dl, [bx] snext command character 
inc bx eto next command positio 
mMOv Ah ,0 ezero high byte for add 
or Al,dl scheck for end of comman 
inz getnum 
ret 
: not zero, numeric? 
getnum: 
sub d1l,°0° 
cmp d1,10 scarry if numeric 
inb endrd 
mov c1,10 
mul cl emultipy accumulator by 
add ax ,ax etdigit 
jmps readc efor another char 
endrd: | 
: end of read, restore value in a and return value 
mov ax ,ax ereturn value in NX 
mov al,-l[bx] 
cmp al, a. echeck for lower case 
jnb transl 
ret 
transl: and al,5fH ;translate to upper case 
ret 
? 
0 
- Template for Page 0 of Nata Group 
H Contains default FCB and DMA buffer 
0 
dseg 
org 05ch 7 
fcb rb 33 sdefault fiile control b]. 
ranrec rw 1 erandom record position 
ranovf rb 1 ehigh order (overflow) b 
buff rb 128 sdefault DMA buffer 
: | 
2 string data area for console messages 
badver db “sorry, you need cp/m version 2S* 
nospace ab “no directory spaceS$~ 
datmsg db “type data: 
errmsg Ab “error, try again.$~ 
prompt Ab “next command? S* 
. | 
. fixed and variable data. area 
’ 
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276: conbuf db conlen ;length of console buffer 
277: consiz rs 1 eresulting size after read 
278: conlin rs 32 slength 32 buffer 

279: conlen equ offset $ - offset consiz 

280: ; 

281: rs 31 216 level stack 

282: stack rb 1 

283: db 0 send byte for GENCMN 

284: end 
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Listing of the Boot ROM 


KKK HK KKH KKK KKK KKK KKK KKEKKKKKKKRRKKRKRKKKKRKKKKEE 


* * 
* This is the original BOOT ROM distributed with CP/M * 
* for the SBC 86/12 and 204 Controller. The listing * 
* is truncated on the right, but can be reproduced by * 
* assembling ROM.A86 from the distribution disk. Note * 
* that the distributed source file should always be * 
* referenced for the latest version * 
& *& 
*& * 


HHH KK HK KKK HK KKK HHH KKK KKK KKEKRKEKEKKEKKKEKREE 


ROM bootstrap for CP/M-86 on an iSBC86/12 
with the 
Intel SBC 204 Floppy Disk Controller 


Copyright (C) 1980,1981 
Digital Research, Inc. 

Box 579, Pacific Grove 

California, 93950 


@ %e TO WO WOH BQ WH WH WE WOH ® 


+ 


KHKKKKKEKKKHEKKKKKKKKKKEKKKKKKKKKRKRKKRKRKRKKRKEKEKRK 


* This is the BOOT ROM which is initiated * 
* by a system reset. First, the ROM moves * 
* a copy of its data area to RAM at loca- * 
* tion 00000H, then initializes the segment* 
* registers and the stack pointer. The * 
* yarious peripheral interface chips on the* 
* SBC 86/12 are initialized. The 8251 * 


serial interface is configured for a 9600* 
baud asynchronous terminal, and the in- 
terrupt controller is setup for inter- 
rupts lOH-17H (vectors at 00040H-0005FH) 
and edge-triggered auto-EOI (end of in- 
terrupt) mode with all interrupt levels 
masked-off. Next, the SBC 204 Diskette 
controller is initialized, and track l 
sector 1 is read to determine the target 
Paragraph address for LOADER. Finally, 
the LOADER on track 0 sectors 2-26 and 
track 1 sectors 1-26 is read into the 
target address. Control then transfers 
to LOADER. This program resides in two 
2716 EPROM’s (2K each) at location 
OFFOOOH on the SBC 86/12 CPU board. ROM 
0 contains the even memory locations, and 
ROM 1 contains the odd addresses. BOOT 
ROM uses RAM between 00000H and OOOFFH 
(absolute) for a scratch area, along with* 


the sector 1 buffer. | * 
HH KHER KKKRKKKRRKKKKRKKKRRKEE 


=e ZO, TO VS VO WH ZH VH VO VS VEOH VO ze TO VE VO WH VO VO WOH WH WOH WH VE -™e 26 tO @O & 
+e * FF FF HF HF HF HF HF HF HF HF HF F 


+e He FF FH FH HH FH OF HF OH HH HH HH OF 


=e 


All Information Presented Here is Proprietary to Digital Research 


103 


CP/M-86 System Guide 


OOFF 
FFOO 


OOFF 


000D 
000A 


OOA0 
OOAO0 
OOA0 
OOAL 
OOA1 
O0A2 
O0A4 
OOA5 
OOA6 
O0A7 
00A8 
O0A8 
O0A9 
OOAA 
OOAF 


2580 


0008 


OONA 
00D8 


00DO 
00D2 
00D4 
00D6 


00C0 
00C2 


FEOO 


Appendix 


true equ 
false equ 
debug equ 


edebug = true indicates 


C Listing of the BOOT ROM 
Of fh 
not true 


true 
bootstravod is in same roms 


swith SBC 957 "Execution Vehicle" monitor 
sat FEO0:0 instead of FFO00:0 


e 
o 


Cr equ 13 

lf equ 10 

° Aisk vorts and commands 
base204 equ Oa0h 
fdccom equ base204+0 
fdcstat equ base204+0 
fdcparm equ base204+1 
fderslt equ base204+1 
fderst equ base204+2 
damacadr equ base204+4 
dmaccont equ base204+5 
dmacscan equ base204+6 
dmacsadr equ base204+7 
dmacmode equ base204+8 
dmacstat equ base204+8 
fdcsel. equ base204+9 
Fdcsegment equ base204+10 
reset204 equ base204+15 


g 
eactual console baud rate 


baud rate equ 


9600 


svalue for 8253 baud counter 


baud equ 
ests equ 
cdata equ 
tch0 equ 
tchl equ 
tch2 equ 
temd equ 
icpl equ 
icp2 equ 


TF NOT DEBUG 


ROMSEG | EOU 
ENDIF 
IF DEBUG 
ROMSEG BOW 
ENDIF 


=e WO 


768/(baud_rate/100) 


ONAh °18251 status port 
Onsgh ais data port 


On0h 28253 PIC channel 0 
tch0O+2 ;ch 1 port 

tch0+4 :ch 2 port 

tch0+6 ;8253 command port 


O0cOh °8259a port 0 
Ooc2h °8259a port l 


OFFOOH +:normal 


eshare orom with SB 
OFFO00H 
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FEOO 


0000 
0002 
0004 
0007 
000A 
000nN 
O0OF 
0012 


0014 
0017 
0019 
0018 
OO1E 


8CC8 
8EN8 
BE3FO1 
BFO002 
B80000 
8ECO 
B9F600 
F3A4 


B80000 
8ED8 
8EDO 
BC 2A03 
FC 


OO1lF BO13 
0021 E6CO 


0023 


BO10 


Guide 


=e 636 WO 


=e eq VO 


TT) 


ewe meq TO 


~e 


ze we WO 


=e ~O@ VO BVO WH WH VWES 


First, 


Now, 


This long jump 
OfFFEE 
BOTTOM 


cseg 

EA 00 00 OO FF 
EVEN PROM 

7-8 - FA 

7F9 - 00 

7FA - FF 

cseg 


Appendix ¢ 


romseg 


Listing of the BOOT ROM 


prom’ d in by hand 


ereset goes to here 
sboot is at bottom 
cs = bottom of pro 


ip = 0 
ODN PROM 
7-8 - 00 
7F9 - 00 


ethis is not done j. 


move our data area into RAM at 0000:0200 


MOV 
MOV 
mov 
MOV 
MOv 
mov 
MOV 
reo 


MOv 
mov 
MOV 
mov 
cl1ld 


IF NOT DEBUG 


MOv 
out 
mov 
out 
mov 
out 
mov 
out 
mov 
out 
mov 
out 
MOv 
out 


ax,cs 
ds ,ax 


SIT,drombegin 


spoint NS to CS for source 
estart of data 


NT,offset ram_start ;offset of destinat 


ax,0 
es ,ax 


CX,data_lLength 
movs al,al. 


ax,9 
ds ,ax 
ss,ax 


so,stack offset 


initialize the console TJSART and baud 


al,0OEh 
csts,al 
al,40h 

csts,al 
al, 4Eh 

csts,al. 
al,37h 

csts,al 
al ,OB6h 
tcmd,al 
ax ,baud 
tch2,al. 
al,ah 

tch2,al 


ENDIF 


destination segment is 000 
show much to move i 
smove out of eprom 


;data seqment now in RAM 


;Initialize stack s 
;clear the directio 


rate 


sgive 8251 dummy mode 
sreset 8251 to accept mode 
snormal 8 bit asynch mode, 
senable Tx & Rx 

78253 ch.2 square wave mode 
slow of the baud rate 


shigh of the baud rate 


Setup the 8259 Programmable Interrupt Controller 


mov 


out icpl,al 


mov 


al, 13h 


al,1lOh 


°8259a ICW 1 8086 mode 
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0025 
0027 
0029 
002B 
002D 


002F 
0031 
0033 
0035 
0037 
0039 
003C 
003F 
0042 
0045 
0048 
004B 
004E 


0051 
0054 
0057 
0059 


005C 
O0O5F 


0062 
0066 
0069 


006C 
O06F 
0072 
0075 


0078 


007C 


0082 


0086 
0088 
008A 
008c 
(008F 
0090 


E6C2 
BOIF 
E6C2 
BOFF 
E6C2 


E6AF 
BOO1 
E6A2 
B000 
E6A2 
BB1502 
E8E100 
BB1B02 
E8DB00 
BB2102 
E8D500 
BB1002 
E85800 


BB2A03 
B80000 
8ECO 

E8A700 


BB0202 
E8 4700 


8E062D03 


BB0000 
E89700 


BB0602 
£83700 
BBOBO2 
E83100 


8C06E802 


C706&6020000 


FF 2EE602 


SAOF 
84C9 
7476 
E80400 
43 
E9F3FF 


Guide Appendix C Listing of the BOOT ROM 


out icp2,al °8259a ICW 2 vector @ 40-5 
mov al,lFfh 
out icp2,al 
mov al,OFfFh 


out icp2,al 


-28259a ICW 4 auto FOI mast 


28259a OCW 1 mask all teve 


0 

sReset and initialize the ijSBC 204 Diskette Interfa 
restart: | salso come back here on fatal error 
out reset204,AL ;reset iSBC 204 logic and 
mov AL,l 

out fdcrst,AL 
mov al,0 

out fdcrst,AL ° a reset command 
mov Bx,offset svecsl 

CALL sendcom ;program 

mov Bx,offset specs2 

CALL sendcom ; Shugart SA-800 drive 
mov BXx,offset specs3 

call sendcom =; characteristics 
mov BX,offset home 

CALL execute shome drive 0 


egive 8271 FDC 


homer : 


ze 


mov bx,sectorl 
mov ax,0 

mov esS,ax 

call setup_dma 


soffset for first sector DM 


eseqment " 7) 0 7) 
tf ; 


26 


mov bx,offset read0 
call execute eget TO Sl 


=e 


mov es,ARS 
mov bx,0 
call setup dma 


eget loader load address 
ssetupd NMA to read loader 


=o 


mov bx,offset readl 
call execute eread track 0 
mov bx,offset read2 
call execute eread track 1 


=o 


mov leav_segment,ES 
° setup far jump vector 
mov lean offset,0 


enter LOADER 
jmpf dword ptr leap _offset 


mov cl, [BX] 
test cl,cl 
jz return 
call conout 
inc BX 

jmp pmsg 


e 
0 
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0093 
0095 
0097 
0099 
0098 
009D 


O09E 
O0AO0 
00A2 
O0A4 
OOA6 
00A8 


O0A9 


OOAD 


0080 
00B4 
00B7 
0089 
0OBC 
OOBE 
00CO 
00C3 
00C5 
00C7 
00C9 


0OCB 
00CD 
0OCF 


00n3 
00D5 
00D7 


00D9 
OODB 


00ND 
00E0 


E4DA 
A801 
74FA 
8AC1 
E6D8 
C3 


E4NA 
A802 
74FA 
E4D8 
247F 
C3 


89180002 


E87000 


8B1E0002 
8A4701 


243F 


B90008 


3C2C 
720B 


B98080 


240F 
3CO0C 
BO00 
7737 


E4A0 
22C5 


32C174F8 


E4Al 
2415 
7429 


3C10 
7513 


BB1302 
E83D00 


Guide 


conout: 


conin: 


iD ~e se se 


xecute: 


retry: 


Appendix C 


_in al,csts 
test al,l 

jZ conout 

mov al,cl 

out cdata,al 


ret 


in al,csts. 
test al,2 
1Z conin 

in al,cdata 
and al,7Fh 


ret 


Listing of the BOOT ROM 


sexecute command string @ [BX] 
*<BX> points to length, 

followed by Command byte 

>followed by lenath-1l varameter hvt 


mov Tastcom,BX 
call sendcom 
mov BX, Lastcom 
MOV AL, 1 [BX] 
and AL, 3fh 

mov cx ,0800h 
cmp AL, 2ch 

ib execpol 1 
MOV cx ,8080h 
and AL,OfFh 

cmo AL,Och 

mov AL,0O 


; 
execpo] 1. 


=e 


=e 


ja return 


xor AL,CL 


in 
and 
iz 


sremember what it w 
eretrv if not readv 
eexecute the comman 
snow, let’s see wha 
eof status vol! was 
efor that command t 
epoint to command s 
eget command op cod 
edrov drive code bi 
emask if it will be 
esee if interrupt t 


eelse we use "not c 
seunless . . 
sthere isn’t 


seany result at all 


spoll for bit in b, toaqled with c 
in AL,FNCSTAT 
and AL,CH 


AL,fdcrslt 
AL, Leh 
return 


cmp al,1l0h 
jne fatal 


mov bx,offset rdstat 


cajJ.l1 sendcom 


! 7Z execpoll 


e 
e 
_ @ 
v 
e 
0 


get result registe 
look only at resul. 
zero means it was 


eif other than "Not 


eperform read statu 
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003 
O0E5 
0087 
00E9 
~OOED 


OOFO 
O0F2 
OOF4 


0O0OF8 
OOFB 
OOFE 
OOFF 


0102 


0103 
0105 
0107 
0109 
010B 
010D 
O10F 
0111 
0113 
0115 
0117 
0119 
011B 
011D 
011F 


0120 
0122 
0124 
0126 
0128 
0129 
012B 


012D 
012F 
0131 


0132 
0134 
0136 


F4A0 
A880 
75FA 


8B1E0002 
ESBDFF 


B400 
8BN8 


8B9F2702 


E88BFF 


E4A0 
2480 
75FA 
8A0F 
43 

8A07 
E6A0 


FEC9 
74D1 
43 


E4A0 


2420 
75FA 


rd poll: 


Appendix C Listing of the BOOT ROM 


in al,fdec stat 


test al,80h 


jnz 
mov 
Imp 


; 

fatal: 
mov 
Mov 


rd_poll. 
bx,last_com 
retry 


ah ,0 
bx ,ax 


ewait for command n 


erecover last attem 
sand try it over ag 


* fatal error 


emake 16 bits 


mov bx,errtbl [BX] 


ze 


call pmsg 
call conin 


pop 
Imp 

, 

returns: 
RET 

setuvdma: 
mov 
out 
mov 
out 
mov 
out 
mov 
out 
mov 
out 
mov 
out 
mov 
out 
RET 


( ~e re ~e 


sendcom: 
and 
jnz 
mov 
inc 
mov 
out 
parmloop: 
dec 


ax 
restart 


AL,04h 
dmacmode , AL 
al,0 
dmaccont ,AL 
AL, 40h 
dmaccont , AL 
AX,ES 


print appropriate error message 


ewalt for key strik 
ediscard unused ite 
ethen start all ove 


sreturn from EXECUT 


senable dmac 


sset first (dummy) 


force read data mo 


fdcsegment ,AL 


AL, AH 


fdcsegment ,AL 


AX , BX 
dmacadr ,AL 
AL ,AH 
Amacadr , AL 


sroutine to send a command string t 
in AL,fdcstat 


AL,80h 
sendcom 
CL, [BX] 
BX 

al, [BX] 
fdccom,AL 


CL 


jz return 


inc 
parmpoll: 


BX 


in AL, fdcstat 


and 
jnz 


AL, 20h 
parmpol.1. 


sinsure command not busy 
eget count 


spoint to and fetch command 
«send command 


esee if any (more) paramete 
spoint to next parameter 


:;loop until parm not full 
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0138 


8A07 


013A E6AL 


013C EQEEFF 


013F 


013F 


0141 
0142 
0143 
0144 


0145 
0146 
0147 
0148 
0149 


O14A 
0148 
014C 
014D 
014E 


O14F 
0152 
0154 
0157 
O15A 
015D 
0160 
0163 


0000 


03 
52 
00 
O01 


04 
53 
00 
02 
19 


04 
53 
O01 
01 
1A . 


026900 
016C 

05350D 
0808E9 
053510 
FFFFFF 
053518 
FFFFFF 


0166 4702 
0168 4702 
016A 4702 
016C 4702 
O16E 5702 
0170 6502 
0172 7002 
0174 7FO02 
0176 9002 
0178 A202 
017A B202 
017C C502 
O17E D302 
0180 4702 
0182 4702 
0184 4702 


mov AL, [BX] 
out fdcparm,AL 
jmp varmloop 


Lastcom 


~e Q ~e GQuse se se ve 


creadstring 


creadtrk0 


creadtrkl 


chome0 
crdstat0 
cspecsl 
cspecs2 


cspvecs3 


cerrtbl dw 
dw 
Aw 
dw 
dw 
dw 
dw 
dw 
dw 
aw 
dw 
dw 
dw 
dw 
dw 
dw 


0186 ODOA4E756C6C Cer0 db 


. 


Appendix 


rombegin equ offset S$ 


dw 


Ab 
db 
db 
ab 


db 
db 
db 
db 
db 


db 
db 
Ab 
Ab 
db 


ab 
dab 
db 
db 
Ab 
db 
Ab 
db 


offset' 
offset 
offset 
offset 
offset 
offset 
offset 
offset 
offset 
offset 
offset 
offset 
offset 
offset 
offset 
offset 


C Gisting of the BNOT ROM 


eoutout next parameter 
ego see about another 


Image of data to be moved to RAM. 


0000h elast command 
3 elength 
52h eread function code 
0 etrack # 
1 esector # 
4 
53h eread multivle 
0 etrack 0 
2 esectors 2 
25 ethrough 26 
4 
53h 
1 etrack L 
1 esectors l 
26 ethrough 26 
2,69h,0 
1,6ch 
5,35h,0dh 
08h,08h,0e9h 
5,35h,10h 
255,255,255 
5,35h,18h 
255,255,255 

er0Q 

erl 

er2 

er3 

er4 

er5 

er6 

er7 

er8 

er9 

erA 

erB 

erCc 

erD 

ert 

erF 


cr,lf,°Null Error ??°,0 
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204572726F72 
203F3F00 


0186 
0186 
0186 


0196 


O1A4 


O1AF 


O1BEF 


O1CF 


O1Fl 


O1F1 


ODOA436C6F63 


68204572726F 
7200 
0OD0A4C617465 
20444D4100 
0N0A49442043 
524320457272 
6F7200 
0N0A44617461 
204352432045 
72726F7200 
0D0A44726976 
6520 4F6F7420 
526561647900 
0D0A57726974 
652050726F74 
65637400 
0D0A54726B20 
3030204E6F74 
20466F756F64 
00 
0N0A57726974 
65204661756C 
7400 
0N0A53656374 
6F72204F6F74 
20466F756E64 


Guide 

Cerl equ 
Cer2 equ 
Cer3 equ 
Cer4. db 
Cer5 db 
Cer6 ab 
Cer7 ab 
Cer8 db 
Cer9 Ab 
CerA db 
CerB db 
Cerc db 
CerD equ 
Cerk equ 
CerF equ 


dromend equ 


data_length 


=e 260 we BO 


dseg 
Org 
ram start 
lastcom 
read0 
readl 
read2 
home 
rdstat 
specsl 


Appendix C Listing of the BOOT ROM 


cer0 
cer0 
cer0 
cr,lf,°Clock Error’ ,0 


cr,lf,~ tate DMA’ ,0 


cr,1f,°ID CRC Frror’” ,0 
cr,l£,°“Nata CRC Frror’ ,0 
cr,lf,°Nrive Not Ready” ,0 
cr,lf,°“Write Protect” ,0 


cr,lf,°Trk 00 Not Found’ ,0 


cr,lf,°Write Fault” ,0 


cr,l1f,°Sector Not Found” ,0 


cer0O 
cer0 
cer) 
offset S 


equ dromend-drombegin 


reserve space in RAM for data area 
(no hex records generated here) 


0 

0200h 

equ —$ 

rw Ll slast command 

rb 4 eread track 0 secto 
rb 5 eread TO S2-26 

rb 5 eread T1 S1-26 

rb 3 shome drive 0 

rb 2 sread status. 

rb 6 
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0218 
0221 
0227 
0247 
0247 
0247 
0247 
0257 
0265 
0270 
027F 
0290 
02A2 
02B2 
02C5 
02D3 
0247 
0247 
0247 


02F6 
02E8 


02EA 
032A 


032A 


032A 
0328 
032nN 
032F 
0331 


specs2 
specs3 
errtbl 
er0 
erl 
er2 
er3 
er4 
er5 
er6 
er7 
er8 
er9 
erA 
erB 
erc 
ern 
erF 
erF 


a 
lean offset 
leap_segment | 


-me TO 


stack offset 


e 
0 


v 
sector l 


e 
a 


Ty 

Len 
Abs 
Min 
Max 
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rw 
eau 


32 


cer0 


cer4 
cer5 
cer6 
cer/7 
cer8 
cer9 
cerA 
cerB 
cerc 


slocal stack 
offset S$;:stack from here do 


TO Sl read in here 
equ offset S 


rb 
rw 
rw 
rw 
rw 
end 


ee oo oll oll 


eABS is all we care 
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erties 


Appendix D 
LDBIOS Listing 


KH KI KK KKK KK IKK IKKE KKKKKKKKRKRKKKKKKKKKKKKEKE 


* 

* This the the LOADER BIOS, derived from the BIOS 
* program by enabling the "loader _bios" condi- 

* tional assembly switch. The listing has been 

* adited to remove vortions which are Auvlicated 
* in the BIOS listing which avvears in Appendix Nn 
* where elipses "..." denote the deleted nortions 
* (the Listing is truncated on the right, but can 
* be reproduced by assembling the BIOS.A86 file 

* provided with CP/M-86) 

* 
* 


+e + FF FOF HF HF HF OF 


KKK KKK KKK IK KKK KKK KEKE KKK KKEKKKKKKKKK KKK KKK 


KKK KKK KKK IK KKK KKK KKK KK KEKKEKEKKEKKKKKKRKEREKEKEEEE 


Basic Tnout/Output System (BIOS) for 
CP/M-86 Configured for iSBC 86/12 with 
the iSBC 204 Floopy Disk Controller 


ee ~O@ EO TO VEO x) 


+ oF FF OF OF 


tabs and blanks to minimize the list file * 
width for printing vurposes. You mav wish* 
to expand the blanks before Per noEmung:, * 


major editing.) * 
ke RR KHER KK KK KK KKK KR Raa RR RK RK RIK RK 


Tt i eT 


* 
* 
* 
* 
* 
* 
* (Note: this file contains both embedded 
* 
* 
* 
* 
* 


-e 


Copyright (Cc) 1980,1981 
Digital Research, Inc. 
Box 579, Pacific Grove 
California, 93950 


(Permission is herebv granted to use 
or abstract the following program in 
the implementation of CP/M, MP/M or 
CP/NET for the 8086 or 8088 Micro- 
processor ) 


SS ee. ee ed | =e 8 20 ee 38 RO 


FFFF true equ -l 
0000 false equ not true 
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FFFF 
FFFF 
00E0 


1200 
0003 
0406 


1200 E93C00 
1203 E96100 


1239 E96400 
123C £96400 


Appendix D LDBIOS Listing 


g RR KERR EERE ERE EERE EERE RERERERE EER ERE ES 


= 
e* versions. 


loader bios 
ble list 
bdos_int 


+ | 
bios code 
cep offset 


bdos_ofst 
’ 
ENDIF 
cseg 
org 
ccp: 
org 


;* Loader bios is true if assembling the 
>* LOADER BIOS, otherwise BIOS is for the 
>* CPM.SYS file. 
e* have a serial printer attached to BLC8538 
©* Bdos int is interrupt used for earlier 


Blc_list is true if we 


+ ee + & & HF 


’ 
gH RRR RRR REE RRR EKER EEE RHE EE RRR ER ERE EE 


equ true 
equ true 
equ 224 ;reserved BNOS Interrupt 


not loader bios 


snot loader bios 


loader _bios 


equ 1200h ;:start of LNBIOS 
equ 0003h ;base of CPMLOADER 
equ 0406h ;strivped BDOS entrv 


;loader bios 


ccpoffset 


bios code 


g KH RRR RR RRR ERE RIKER EERE RE RKEE REE RE RENEE 


o* 
e 


o* 
g 


* 


e* BIOS Jump Vector for Individual]. Routines * 
*& 


o KKK KR KR RE KK EKER KEK RE RKEREKRRE RE RRERE RR ERE REE 


jmp INIT 
jmp WROOT 
jmp GETIOBF 
jmp SETIOBF 


sEnter from BOOT ROM or LOADER 


-sArrive here from BDOS call 0 


sreturn I/O map byte (IOBYTE) 
eset I/O map byte (IOBYTE) 
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1248 
124C 
124F 


1251 
1257 
125B 


125C 
125F 
1262 
1264 


1267 


8CC8 
8ED0 
8ED8 
8ECO 


BCA916 
FC 


1E 
B80000 
8ED8 


C70680030604 
8C0E8203 
LF 


BB1514 
E85A00 
B100 
E99CED 


E99FED 


Guide Appendix D WLDRIOS Listing 


ga KERR REE RRR REE EES 


«* * 
a 

>* INIT Entry Point, Differs for LDBIOS and * 
-* BIOS, according to “Loader Bios" value * 
e* _ * 


g IK I IH HRI RR HIKER RRR IRR EERE REE ERE EE 


INIT: sprint signon message and initialize hardwa 
mov ax,cs ewe entered with a JMPF so 
mov sS,ax > CS: as the initial value 
mov ds,ax : nSs, 
mov es,ax : and ES: 
suse local stack during initialization 
mov sv,offset stkbase 
cld eset forward direction 
IF not loader bios 

: | | 
- This is a BIOS for the CPM.SYS file. 

? | e e e . 

ENDIF snot loader_bios 
IF loader bios 

Bp kee ane So eeage Pao te oat a eee 
-This is a BIOS for the LOADER 
push ds save data segment 
mov ax,0 
mov ds,ax spoint to segment zero 
eBDOS interrupt offset 
mov bdos offset,bdos ofst 
mov bdos_segment,CS ;bdos interrupt segment 
pop ds erestore data segment 

: | 

ENDIF  ;loader_bios 
mov bx,offset signon 
call pmsg sprint signon message 
mov c1,0 edefault to dr A: on coldst 
jmp ccp ejump to cold start entry o 

WBOOT: jmp ccpt6 edirect entry to CCP at com 

IF not loader bios 


e aasw ew aE EOE we OO EO Ow OO wee ee ee wee eee eee eee 


ENDIF snot loader_bios 
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126A 


1272 


1273 


127D 


1288 


L291 


1292 


129C 


129D 
129F 


E4DA 


C3 


ESF4FF 


E4DA 


E80700 


E441 


C3 


BO1A 
cS 


Appendix N LNMBIOS Listing 


KKK RK KAKA E KER ER ERER KEKE REREE REE ® 


o* & 
el CP/M Character I/O Interface Routines * 
2 * Console is Usart (i825la) on iSBC 86/12 * 
.* at ports D8/NA * 
ex 
oR RR KR RK RR RR REE REE RR RRR REE KERR RRR ER EE 


CONST: econsole status 
in al,csts 


const_ret: 
ret sReceiver Data Available 


CONIN: sconsole input 
cal.l const 

CONOUT : econsole output 
in al,csts 


LISTOUT: elist device output 


IF ble _list 


ENDIF ;blce_list 
ret 
LISTST: spol] list status 


IF ble list 


ENDIF ;ble_list 
ret 


PUNCH : snot implemented in this configuration 
READER: 

mov al,lah 

ret ereturn EOF for now 
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12A0 
12A2 


12A3 


12A4 
12A6 


12A7 


L2CA 


L2EB 


1300 
1304 


1305 
1309 


130A 


1311 
1315 


1316 
131A 


131B 
1316 


BO000 
ca 


C3 


2400 
C3 


E8C9FF 


BB0000 


Cc606311500 


88083115 
C3 


880E3215 
C3 


8BD9 


890E2A15 
C3 


890E2C15 
C3 


BB3815 
C3 


Appendix DN LNBIOS Listing 


GETIOBF: 
| mov al,0 sTTY: for consistency 

ret eIOBYTE not implemented 
SETIOBF: | 

ret eiobyte not implemented 
zero _ret: 

and al,0 
ret sreturn zero in AL and Flag 


Routine to get and echo a console character 
and shift it to upper case 


oT ) YT ) 


uconechos: 
call CONIN 


SII IIIT III IIIT OI II IRI IIR IRR RIE EE ES 


eget a console character 


o* * 
il | Nisk Input/Output Routines * 
e * * 


WICC ICICI TOI ICICI ITO IIA TOI III IRR IIE SEES 


SELNSK: eselect disk given by register CL 


mov bhx,9000h 


HOME: smove selected disk to home position (Track 
mov trk,0O eset disk i/o to track zero 

SETTRK: ;set track address given by CX 
mov trk,cl ewe only use 8 bits of trac 
ret 

SETSEC: ;set sector number given by cx 
mov sect,cl swe only use 8 bits of sect 
ret 

SECTRAN: ;translate sector CX using table at [NX] 
mov bx,cx 

SETDMA: ;set DMA offset given by CX 


mov dma_adr,Cx 
ret 


SETDMAB: ;set NMA segment given by CX 
mov dma_seq,CxX 
ret 
g 
GETSEGT: j;return address of physical memory table 
mov bx,offset seg_table 
ret 
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cK RRR RRR K EERE REE ERE EE REERERE RE REE RES 


*® 
-* All disk I/O parameters are setup: the * 
-* Read and Write entry points transfer one * 
e* sector of 128 bytes to/from the current * 
-* DMA address using the current disk drive 7 

* 


, 
oR RR RII KK II I RRR RK ERK RE ER ER ERE REE EE 


READ: 
131F BO12 mov al,l2h ebasic read sector command 
1321 EBO2 jmps r_w_common 

WRITE: 7 
1323 BOOA mov al,Oah sbasic write sector command 


r_w common: 
1325 BB2F15 mov bx,offset io com ;point to command stri 


ok a a a KR KR KR RK KK IK KER HR E KER ERR REE 


el * 
2 * Nata Areas * 
o* te 


, 
oe KK KK IK KK IK KR RK KR RK EKER EK RRR ERE E 


1415 data offset equ offset S 
dseg 
org data_offset ;contiaquous with co 
IF loader bios 
| | 
1415 ODOAODOA signon db Cr 1 cr ett 
1419 43502F4D2D38 db “cp/M-86 Version 2.2°,cr,1£,9 
362056657273 
696F6E20322F 
320N0A00 


ENDIF ;loader bios 


If not loader bios 
| ; | 
. de dials. os | 
a ENDIF ;not loaderbios = 
142F ODOA486F6N65 bad_hom db cr,lf,“Home Frror’,cr,1f,0 


include singles.lib ;read in disk definitio 
NISKS 2 


=e 
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= 1541 
=1668 00 


1669 
16A9 


16A9 00 


0000 


dpbase equ $ | sBase of Disk Param 


ab 0 eMarks End of Modul. 


loc_stk rw 32 ;local stack for initialization 
stkbase equ offset § 


db 0 efill last address for GENCMN 


o RK KKH HK KKK REE RIKER ER ERK KE RE REE KER EERE EERE 


eX * 

0 

2% Dummy Nata Section * 

rgd te 

g RR KK HHH EK KR KRIEKKKHRRE KR KKREK EEE RREREREREEEE 
dseg 0 sabsolute low memory 
org 0 e(interrupt vectors) 
END 
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HH KI HHI IKI I KHIR IKK IKI KKK KR KEKREKKEKEKKKRKKEKKKKEKES 


* This is the CP/M-86 BIOS, derived from the BIOS 
* program by disabling the “loader_bios" condi- 

* tional assembly switch. The listing has been 

* truncated on the right, but can be reproduced 

* by assembling the BIOS.A86 file provided with 

* CP/M-86. This BIOS allows CP/M-86 operation 

* with the Intel SBC 86/12 with the SBC 204 con- 
* troller. Use this BIOS, or the skeletal CBIOS 
* listed in Appendix E, as the basis for a cus- 

* tomized implementation of CP/M-386. 

* provided with CP/M-86) 

* 
* 


+ Fe + FF FF HF HF HF F 


HK KK HK HHI KH II IKKE KEKE KK KKK KKRKKKRKKKKEKK 


oR IH I KKK RRR EKER EER IK EHH EER ERE REE RES 


°* Basic Input/Output System (BIOS) for 
2* CP/M-86 Configured for iSBC 86/12 with 
>* the iSBC 204 Floppy Disk Controller 


+ + + * F 


s* (Note: this file contains both embedded * 
e* tabs and blanks to minimize the list file * 
°* width for printing purposes. You may wish* 
e* to expand the blanks before performing i 
¢* major editing.) * 


g RK KKK KHER ERR REE HERE ERE KEKE KKK EERER ERE RENE 


Copyright (C) 1980,1981 
Digital Research, Inc. 


Box 579, Pacific Grove 
California, 93950 


(Permission is hereby granted to use 
or abstract the following program in 
the implementation of CP/M, MP/M or 
CP/NET for the 8086 or 8088 Micro- 


=e ~OE BVO WE WE WH WH WE VSO WS 


processor) 
FFFF true equ -l 
0000 | false equ not true 
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g RRR RRR RR REE RRR ERR ERE RR EKER EEE ES 


* 
e* Loader bios is true if assembling the * 
-* LOADER BIOS, otherwise BIOS is for the * 
>* CPM.SYS file. Blc_list is true if we * 
»* have a serial orinter attached to BLC8538 * 
;* Bdos_ int is interrupt used for earlier * 
°* versions. * 

* 

*® 


HH HH IRR RIKI H HR RII R EEE E ES 


0000 loader bios equ false 
FFFF ble list equ true 
000 bdos_int equ 224 ;reserved BNOS Interruot 
IF not loader_bios 
| | 
2500 bios_code equ 2500h 
0000 ccp offset equ 0000h 
0OB06 bdos_ofst equ OB06h ;8NNS entry point 
: | 
SNDIF snot loader _bios 
IF loader bios 
: | | | 
bios code equ 1200h ;start of LDRIOS 
ccp_ offset equ 0003h ;base of CPMLOADER 
bdos_ofst equ 0406h ;strioped BDOS entrv 
"| 
ENDIF ;loader_bios 
OODA ests equ ONAh ;i8251 status vort 
00D8 cdata equ OD8h_ ; " data vort 
IF | ble list 
e | | 
0041 lsts equ 4lh ;2651 No. 0 on BLC8538 stat 
0040 ldata equ 40h ; " " fe ” data 
0060 ble reset equ 60h ;reset selected USARTS on B 


v 


ENDIF ;ble_ jist 


gH HII I KIRK RHR RII R RR EERE EER ERE RE EES 


0% * 
72 Intel iSBC 204 Nisk Controller Ports * 
o ® * 


gERRRREARERKEREAKEERERERER ERE EEERERERERR EEE EELES 
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00OA0 


0O0A0 
OOA0 
OOA1L 
O0A1L 
00A2 
O0A4 
OOA5 
O0A6 
O0A7 
00A8 
00A8 
00A9 
OOAA 
OOAF 


000A 


000N 
OOOA 


base204 


Fdc_com 
Fdc_stat 
fFdc_parm 
fde_rsit 
Fdc_rst 


dmac 


adr 


dmac_cont 
dmac_scan 
admac_sadr 
dmac_mode 


2500 
2503 
2506 
2509 
250C 
250F 
2512 
2515 
2518 
2518 
2515 
2521 
2524 
2527 
252A 
252D 
2530 
2533 
2536 
2539 
253C 
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E93C00 
E98400 
E99000 
E99600 
E99N00 
E9A500 
E9B700 
E9B400 
E9FFOO 
E9DBOO 
E90EO1 
E91001 
E91901 
BE92401 
E92501 
£99100 
£90601 
E9OFO1 
£91101 
E99300 
E99300 


dmac 


_stat 


fde_sel 
fFdc_segment 
reset 204 


max_retries 


Appendix E BIOS Listing 


cr 
lf 
cseg 
org 
ccp: 
org 


equ Oa0h °SBC204 assigned ad 

equ base204+0 28271 FNC out comma 

equ base204+0 ©8271 in status 

equ base204+1 ©8271 out varameter 

equ base204+1 ©8271 in result 

equ base204+2 ©8271 out reset 

equ base204+4 28257 NMA base addr 

equ base204+5 ©8257 out control 

equ base204+6 °8257 out scan cont 
equ base204+7 ©8257 out scan addr 

equ base204+8 ©8257 out mode 

equ base204+8 ©8257 in status 

equ base204+9 eFDC select port (n 

equ base204+10 ;segment address re 

equ base204+15 ;reset entire inter 

equ 10 emax retries on dis 

sbefore verm error 

equ Odh ecarriage return 

equ Oah sline feed 

ccpoffset 


bios code 


III IIIT II II IIIT III IIR IKI RIKI EERE ES 


o* 
e 


Pa 
0 


* 


°* BIOS Jumo Vector for Individual Routines * 
7 # 


FRI III II IIT T IIR RT RI IIH IRI RRR R ERE ELS 


imp 
jmp 
amp 
Imp 
jmp 
jmp 
jmp 
jmp 
jmp 
jmp 
jmp 
imp 
jmp 
imp 
mp 
mp 
Imp 
jmp 
jmp 
jmp 
jmp 


INIT 
WBOOT 
CONST 
CONIN 
CONOUT 
LISTOUT 
PUNCH 
READER 
HOME 
SELDSK 
SETTRK 
SETSEC 
SETDMA 
READ 
WRITE 
LISTST 


SECTRAN | 


SETDMAB 
GETSEGT 
GETIOBF 
SETIOBF 


sEnter from BOOT ROM or LOADER 
sArrive here from BDOS call 0 
ereturn console kevboard status 
ereturn console keyboard char 
ewrite char to console device 
ewrite character to list device 
ewrite character to punch device 
ereturn char from reader device 
emove to trk 00 on cur sel drive 
sselect disk for next rd/write 
sset track for next rd/write 
eset sector for next rd/write 
eset offset for user buff (DMA) 
eread a 128 byte sector 

ewrite a 128 byte sector 

ereturn list status 

sxlate logical->physical sector 
eset seg base for buff (NMA) 
ereturn offset of Mem Desc Table 
ereturn I/O map byte (IOBYTE) 
eset I/O map byte (IOBYTE) 
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253F 
2541 
2543 
2545 


2547 
254A 


254B 
254C 
254F 
2551 


2553 
2559 
255D 
2560 
2563 
2566 


2568 
256E 


256F 
2571 
2573 
2575 
2577 
2579 
257B 
257D 


8CC8 
8EDO 
8ED8 
8ECO 


BCE429 
FC 


1lE 
B80000 
8ED8 
8ECO 


C70600008N25 
8C0E0 200 

BFO 400 
BE0000. 
BOFEOL 

F3A5 


C7068003060B _ 


1F 


BOFF 
E660 
BO4E 
E642 
BO3E 
F642 
BO37 
£643 


Guide Appendix E BIOS Listing 


e RHR KKK KEKE KEKE KEKE REE ER EKREKREREREEKEEKREKE 


o* *. 
>* INIT Entry Point, Niffers for LDBIOS and * 
»* BIOS, according to "Loader Bios" value * 
o* ; = * 


o KKK HK KKK KKH EK KHER EHH REREEEEE KER EEEREE 
INIT: eorint signon message and initialize hardwa 
mov ax,cs ewe entered with a JMPF so 
mov ssS,ax CS: as the initial value 
mov ds,ax YS:, 

mov es,ax and FS: 

suse local stack during initialization 

mov sp,offset stkbase 

cld sset forward direction 


™e 86 6TO 


not loader bios 


- This is a BIOS for the CPM.SYS file. 
¢ Setup all. interrupt vectors in low 
* memory to address trav 

push ds ssave the NS register 

mov ax,0 

mov ds,ax 

mov es,ax eset FS and NS to zero 
ssetup interrupt 0 to address trav routine 


mov int0O offset,offset int_trap 

mov int0O segment,CS 

mov di,4 

mov si,0 sthen provagate 

mov cx,510 strapd vector to 

rep movs ax,ax ;all 256 interruots 


sBDOS offset to proner interrupt 
mov bdos offset,hbdos_ ofst 
pop ds erestore the NS register 


g RHI KK KHIR KIRKE KEKE KEE KK KEKE KHER KEKE EEERKEE 
e* * 
, 


¢* National "BLC 8538" Channel O for a serial* 
°* 9600 baud printer - this board uses 8 Siq-* 
e* netics 2651 Usarts which have on-chip baud* 


°* rate generators. x 
e* * 
g 


o KKK KKK KKK HK KEKE KEKE RE REKREREKKEKEKEKREREEERE 


mov al,OFFh , 

out ble _reset,al ;reset all usarts on 8538 
mov al,4®Eh 

out ldatat+t2,al ;:set usart 0 in asvne 8 bit 
mov al, 3Eh 

out lIdatat+2,al ;set usart 0 to 9600 baud 
mov al,37h 

out ldata+3,al ;enable Tx/Rx, and set up R 
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257F 
2582 
2585 
2587 


258A 


258D 
258E 
2590 
2592 
2595 
2598 


2599 
259B 
259D 

259F 


25Al 


BB4427 
E86600 
B100 

E976NA 


E979DA 


FA 
8CC8 
8ED8 
BB7927 
E85300 
F4 


E4DA 
2402 
7402 
OCFF 


C3 


Guide Appendix E BIOS Listing 
7 | | 
; eww eee www eee www we ewww ww www eww were se see ei eee ee eee 
ENDIF snot loader bios 
IF loader bios 
eThis is a BIOS for the LOADER 
push ds esave data segment 
mov ax,0 | 
mov ds,ax epoint to segment zero 
eBDOS interrupt offset 
mov bdos offset,bdos_ofst 
mov bdos_segment,CS ;bdos interrupt seqment 
pop ds erestore data segment 
3 
ENDIF ;loader_ bios 
mov bx,offset signon 
call pmsg sprint signon message 
mov cl,0 sdefault to dr A: on coldst 
jmp ccp sjump to cold start entry o 
WBOOT: jmp ccp+6 edirect entry to CCP at com 
IF not loader bios 
; aaa awe wee wwe ee we ewww ee www www www weer eee eee 
: | | 
int trav: 
cli sblock interrupts 


mov ax,cs 

mov ds,ax sget our data segment 
mov bx,offset int_trp 

call pmsg | 

hit shardstop 


ENDIF ;not loader_bios 


g RHEE RRR RRR KERRIER ERR ERE EEK ER ER ERE EEE 


ial CP/M Character I/O Interface Routines 
3% Console is UWsart (i825la) on iSBC 86/12 
se at ports D8/DA 


’ 
g RK HRI RRR HR RK RII RRR ERR REE EER RERR ERR REE 


* 


* 
* 
* 
* 
* 


CONST: sconsole status 
in al,csts 
and al,2 
jz const_ret 
| or al,255 ereturn non-zero if RDA 
const_ret: | 
ret sReceiver Data Available 
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25A2 
25A5 
25A7 
25A9 
25AB 


25AC 
25AE 
25B0 
25B2 
25B4 
25B6 


25B7 
25BA 
25BC 
25BE 


25C0 


25C1 
25C3 
25C5 
25C7 
25C9 


25CB 


25CC 
25CE 


25CF 
25D1 


E8F4FF 
74FB 
E4pD8 
247F 
C3 


E4DA 
2401 
74FA 
8AC1 
E6D8 
C3 


E80700 
74FB 
8AC1 
E640 


C3 


E441 
2481 
3C81 
750A 
OCFF 


C3 


BOI1A 
C3 


B000 
C3 


Appendix E RBTOS Listing 


CONIN: sconsole invut 
cal] const 
jz CONIN swalt for RDA 
in al,cdata | 
and al,/fh eread data and remove parit 
ret 
CONOUT ¢ sconsole output 
in al,csts 
and al,l get console status 
jz CONOUT swait for TRE 
mov al,cl 
out cdata,al sTransmitter Buffer Empty 
ret sthen return data 
LISTOUT: slist device output 
IF ble list 
; | | 
call LISTST 
jz LISTOUT ewait for printer not busv 
mov al,cl 
out ldata,al ssend char to TT 810 
, 
ENDIF ;ble_ list 
ret 
LISTST: spoll list status 
IF ble list 
? ep a> GD @@ @® a8 4@ GD @® GD OD GD @® C® 2 GD @® © @® © @® @® @® @® OD © @® @® O® OP © ©! @® ow @® OO OF Ow OO Ow Oo o® oD oP 
; | 
in al,lsts 
and al1,8lh slook at both TxRDY and DTR 
cmp al,8lLh | 
inz zero _ ret ;either false, printer is b 
or al,255 sboth true, LPT is —“— 
ENDIF ;blc list 
ret 
PUNCH: ;:not implemented in this configuration 
READER: 
mov al,lah 
ret sreturn EOF for now 
GETIOBF: 
mov al,0 eT™TY: for consistency 


ret esIOBYTE not imolemented 
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25D2 


25D3 
25nN5 


25D6 
25N9 
25DA 
25DC 
25DF 
25E0 
25E2 
2554 
25E6 
2558 


25EA° 


25EB 
25ED 
25EF 
25F1 
25F3 


. 25F6 


25F7 


25F9 
25FC 
25FF 
2601 
2603 
2606 
2608 
260A 


260D 
260F 
2611 
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C3 


2400 
C3 


BB0000: 


80F902 
7318 
B080 
80F900 
7502. 
BO040 
A26928 


B500 
8BD9 
B104 


SETIOBF: 
ret 


zero_ret: 
| and al,0 
ret 


=e ZO 


uconecho: 
call CONIN 
push ax 
mov cl,al 
call CONOUT 


Appendix E BIOS Listing 


siobyte not implemented 


sreturn zero in AL and flag 


Routine to get and echo a console character 
and shift it to upper case 


sget a console character 


esave and 


pop ax secho to console 

cmp al,~a~ | 

jo uret, sless than “a° is ok 

cmp al, 2° 

ja uret egreater than “z~ is ok 

sub al,’a’-“A” ;else shift to caps 
uret: 

ret 
: utility subroutine to print messages 
omsq: 


mov al, [BX] 
test al,al 
jz return 


sget next char from message 


eif zero return 


mov CL,AL 

call CONOUT eprint it 

inc BX | 

imps pmsg snext character and loop 
oI I III I IR I RIK IR IIR ERR IRR R IER ERE REE 
o* ss *& 
:* Disk Input/Output Routines * 
xX * 
tf 


FI III ITO ICI III IIIT TOR IORI RAI EIR IRE EERE 


SELDSK: sselect 
mov hx,0000h 
cmp cl,2 

jnb return 

mov al, 80h 

cmp cl1,0 

jne sell 

mov al, 40h 
sell: mov sel_mask,al 


mov ch,0 


mov bx,Cx > 
mov cl,4 


127 


disk given by register CL 


ethis BIOS only supports 2 
ereturn w/ 0000 in BX if ba 


sdrive 1 if not zero 

selse drive is 0 

esave drive select mask 
enow, we need disk paramete 


eBX = word (CL) 
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2613 
2615 
2619 


261A 
261F 
2622 
2625 
2627 
262A 
262D 


262F 
2633 


2634 
2638 


2639 
263B 
263D 
263F 


2640 
2644 


2645 
2649 


264A 


D3E3 
81037C28 
C3 


C6066C2800 


BB6E28 
E83500 
T4F2 — 
BB6A27 
E8BEFF 
EBEB 


880E6C28 
C3 


880E6D28 
C3 


8BD9 
O3DA 
8AlLF 
C3 


890E6528 
C3 


890E6728 
€3 


BB7328 


264D C3 


264E 
2650 


BO12 
EBO2 


Apvendix E BIOS Listing 


shl bx,cl smultioly drive code * 16 
screate offset from Disk Parameter Base 
add bx,offset do base 
return: 
ret 
HOME : smove selected disk to home position (Track 
mov trk,0 eset disk i/o to track zero 
mov bx,offset hom_com 
call. execute 3 
jz return shome drive and return if O 
mov bx,offset bad_hom eelse print 
call pmsg >"Home Frror" 
imps home sand retry 


SETTRK: ;set track address given by CX 
mov trk,cl swe only use 8 bits of trac 
ret 


SETSEC: ;set sector number given by cx 


mov sect,cl. swe only use 8 bits of sect 
ret 


SECTRAN: ;translate sector CX using table at [DX] 
mov bx,cx 


add bx,dx sadd sector to tran table a 
mov bl, [bx] eget logical sector 
ret 


SETNMA: ;set DMA offset given by CX 
mov dma_adr,Cx 
ret 


SETDMAB: ;set DMA segment given by CX 
mov dma_seg,CX 
ret 
o 
GETSEGT: +;return address of ohysical memory table 
mov bx,offset seq _ table 
ret 


eRREKKEKEKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKRKKKKEK 


* 
>* All disk I/O parameters are setup: the * 
7;* Read and Write entrv points transfer one * 
7* sector of 128 bytes to/from the current * 
°* DMA address using the current disk drive * 

* 

* 


eKREKKKEEKEKEKKKKKKKKKKKKKKRKRKKKKKKKKKKKRKKKK KEKE 


READ : 
mov al,12h 
Imps r_w_common 


sbasic read sector command 


WRITE: 
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2652 


2654 
2657 


265A 


265E 


2663 
2667 


266A 
266E 
2671 
2674 
2676 
2678 
267B 
267D 
267F 
2681 


2683 
2685 
2687 
2689 


268B 
268D 
268F 


2691 
2693 


2695 


2699 


269B 


BOOA 


BB6A28 
884701 


89166328 


C60662280A 


8B1E6328 
E88900 


8B1E6328 
8A4701 
B90008 
3C2C 
720B 
B98080 
240F 
3C0C 
BOOO 
7736 


E4A0 
22C5 
32C1 
7T4F8 


E4Al 
2415 
7428 


3C10 
7425 


FEOE6228 
75c8 


B400 


e 
, 


execute: 


Appendix © BIOS Listing 


mov al,Oah sbasic write sector command 


_Y_w_common: 


mov bx,offset io_com spoint to command stri 
mov byte ptr 1[BX],al ;put command into str 
fall into execute and return 


sexecute command string. 
[Bx] points to length, 
followed by Command byte, 
followed bv length-l parameter byte 


=e 26 6 


mov last _com,BX ;Save command address for r 


outer retry: 


retrv: 


Tt ) 


exec_ poll: 


dr_rdy: 


=e 6 


sallow some retrving 
mov rtry_cnt,max_retries 


mov BX,!]ast_com 
call send_com stransmit ‘command to 18271 
check status voll 


mov BX,last com 
mov al,l[bx] 
mov cx,0800h 
cmp al,2ch 

jb exec_pol] 
mov cx,8080h 
and al,0Ofh 

cmp al,Och 

mov al,0O- 

ja exec_exit 


eqet command ov code 
emask.iff it will be "int re 


cok if it is an interrupt t 
selse we use "not command b 


eunless there isn’t 


: any result 
s00ll for bits in CH, 
> toggled with bits in CL 


in al,fdc_stat 
and al,ch _ | 
xor al,cl e isolate what we want to 
jz exec_poll sand loov until it ts done 


sread status 


-Nperation complete, 
in al,fdc_rslt ; see if result code indica 
and al,leh 
41z exec exit eno error, then exit 
aes esome type of error occurre 
cmp al,1l0h 
je dr nrdy ewas it a not ready drive ? 
~ ,;no, 
> then we just retry read or write 
dec rtry_cnt 
jnz retry > up to 10 times 
retries do not recover from the 
hard error 


mov ah,0O 
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269D 
269F 
26A3 
26A6 
26A8 
26AB 
26AD 
26AF 
26B1 
26B3 
26B5 
26B7 


26B9 


26BA 
26BD 
26BF 
26C2 
26C4 
26C7 


26CA 
26CD 
26CF 


26D1 
26D3 


2604 


26D7 
26D9 
26DE 
26E0 


26E2 
26E5 


26E8 
26EA 
26EC 
26EE 
26F0 


8BD8 
8B9F9127 
ES 45FF 
E4D8 
E82BFF 
3C43 
7425 
3C52 
74AB 
3C 49 
741A 
OCFF 


C3 


E81A00 
75A4 
E81500 
759F 
BB0228 
E821FF 


E80A00 
74FB 
EB92 


2400 
C3 


E9B3FE 


B640 
F606692880 
7502 
B604 


BB7128 
E80B00 


E4A0 
A880 
75FA 
E4Al 
84C6 


Appendix E BIOS Listing 


mov bx,ax emake error code 16 bits 
mov bx,errtbl [BX] 

call pmsg sprint appropriate message 
in al,cdata eflush usart receiver buffe 
call uconecho sread upper case console ch 
cmp al,~C” 
je wboot_1 

cmp al,~R° 

je outer_retry 
cmp al,“I” 

je z_ret 

or al,255 


scancel 
sretry 10 more times 


signore error 
eset code for permanent err 


exec exit: 


dr_nrdy: 


ret 


shere to wait for drive ready 
call test_ready 
jnz retry 
call test_ready 
jnz retry eif not ready twice in row, 
mov bx,offset nrdymsg 
call pmsg ;"Drive Not Ready" 


eif it*s ready now we are 4 


nrdyOl: 
call test_ready 
iz nrdyOl snow loop until drive ready 
imps retry sthen go retry without decr 
zrets: 
and al,0 
ret sreturn with no error code 
wboot_1: ;can*t make it w/ a short 1 
jmp WBOOT 
o eK KR RERIKE EERE REE EREREKREREERERKERER 
o* & 
0 
;* The i8271 requires a read status command * 
e* to reset a drive-not-ready after the * 
7* drive becomes ready * 


* 


o RHEKKKHEKHEKEKKEKRERREEKEEREREEKEKRKEEEKKEEKRKEEKEEE 


test ready: 


nrdy2: 


dr poll: 


mov dh, 40h sproper mask if dr l 
test sel mask,80h 
jnz nrdy2 | 


mov dh, 04h emask for dr 0 status bit 


mov bx,offset rds_com 
call send_com 


in al,fdc_stat 
test al,80h 


eget status word 


jnz dr_poll ewait for not command busy 
in al,fdc_rslt ;get "special result" 
test al,dh slook at bit for this drive 
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26F2 


26F3 
26F5 
26F7 


26F9 
26FC 
26FE 
2700 
2702 


2704 
2706 
2708 


270A 
270C 
2705 
2710 
2712 
2714 
2716 
2719 
2718 
271D 
271F 
2722 
2724 
2726 


2728 
272A 
272B 
272D 
2731 


2733 
2735 
2737 


C3 


E4A0 
A880 
75FA 


8A4701 | 


3C12 
7504 
B140 
EB06 


3C0A 
7520 
B180 


B004 
E6A8 
B000 
E6A5 
8AC1 
E6A5 


A16528 


E6A4 
8AC4 
E6A4 


A16728 


E6AA 
8AC4 
E6AA 


8A0F 
43 
8A07 


0A066928 


E6A0 


FEC9 
7482 
43 


Guide 


ret 


Avpendix E RIOS Listing 


ereturn status of ready 


g RRR RRR KR KERRIER RR ER HR KERR ERE RE RE RE ERE 


:;* Send com sends a command and parameters 


°* to the i 


8271: 


BX addresses parameters. 


e* if this is a read or write 


*® 

* 

* 

>* The DMA controller is also initialized * 
* 

*& 

& 


0 
g RH a RRR RRR ERK HK ER RRR EERE ERE REESE 


send _com: 


in al,fdc_stat 


test 
jnz 


,;9ee 


mov 
cmp 
jne 
mov 


al, 80h 
send com 


if we have 


al,12h 
write maybe 
cl ,40h 


jmos init dma 


write maybe: 
cmp 
jne 
mov 

init dma: 


ewe have a read or write operation, 


; (CL 
mov 
out 
mov 
out 
MOV 
out 
mov 
out 
mov 
out 
mov 
out 
mov 
out 

dma_exits 
mov 
inc 
mov 


al ,Oah 
dma_exit 
c1,80h 


sinsure command not busy 
sloop until ready 


to initialize for a DMA ope 
sget command byte 
eif not a read it could be 


eis a read command, go set 


sleave NMA alone if not rea 
ewe have write, not read 


setup NMA contr 


contains proper direction bit) 


al ,04h 
dmac_mode,al 
al ,00 
dmac_cont,al 
al,cl 
dmac_cont,al 
ax,dma_adr 
dmac_adr,al 
al,ah 
dmac_adr,al. 
ax,dma_seg 


fdc_segment,al 


al,ah 


fdc_segment,al 


al, [BX] 


or al.,sel_mask 


out 
parm_ 1oop: 
dec 


Fdc_com,al 


cl 


jz exec_exit 


inc 
parm poll: 


BX 


senable dmac 

esend first byte to con 
: load direction register 
esend low byte of DMA 
esend high byte 
esend low byte of segmen 
ethen high segment addre 
sget count | 
eget command 


emerge command ane drive co 
esend command byte 


eno (more) parameters, retu 
epoint to (next) parameter 
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2738 
273A 
273C 
273E 
2740 
2742 


E4A0 
A820 
75FA 
8A07 
E6AL 
EBEF 


2744 


2744 
2748 


276A 


2779 


2791 
2799 
27Al 
27A9 


All Information Presented 


ODOAODOA 

202053797374 
656N2047656E 
657261746564 
20202D203131 
204A61662038 
310D0A00 


ODOA486F6N65 
204572726F72 
O0D0A00 

OD0A496E7465 
727275707420 
547261702048 
616C740D0A00 


B127B127B127 
B127 
C127D127DE27 
EF27 


022816282828 


3D28 
4D28B127B127 
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in al,fdc_stat 


test al,20h 
inz parm_pol!. 


etest "parameter register f 
eidle until parm req not fu 


mov al, [8X] 


out fdc_parm,al 
jJmps parm loop 


send next parameter 
sgo see if there are more D 


oI II RI IO II ITI IIR RIKI KIRK RRR ERE ERES 


* 


Data Areas * 
¥ 


wR III IIR TTR IIR RRR RR IR RHEE KE EERE SE 
data offset 


bad_hom 


int _tro 


errtbl 


dseg 
org 


ENDIF 


db 


db 


equ offset S$ 


data_offset scontiguous with co 


loader bios 


cr, 1f;cr,1Let 
“cp /M-86 Version 2.2%,cr,1€,0 


; Loader _bios 


not loader_bios 


cr,lf,cr,l1f 


System Generated - 11 Jan 81° ,c 


snot loader bios 


cr,lf,’Home Error’ ,cr,l1f,0 


cr,lf,° Interrupt Trap Halt’ ,cr,lf,0 


Aw er0,erl,er2,er3 


Aw er4,er5,er6,er/7 


Aw er8,er9,erA,erB 


dw erC,erD,erE,erF 


Here is Proprietary to Digital Research 


132 


CP/M-86 System 


27B1 


B127 


ODO0A4E756C6C 
204572726F72 
203F3F00 


27B1 
27B1 
27B1 


27C1 
27N1 
27DE 


27EF 


2802 


2816 


2828 


283D 


284D 


OD0A436C6F63 
6B204572726F 
72203A00 
ON0A4C617465 
20444N41203A 
00 
0D0A49442043 
524320457272 
6F72203A00 
0D0A44617461 
204352432045 
72726F72203A 
00 
0D0A44726976 
6520 4E6F7420 
526561547920 
3A00 
0N0A57726974 
652050726F74 
656374203A00 
0OD0A54726B20 
3030204E6F74 
20466F756E64 
203A00 
0D0A57726974 
65204661756C 
74203A00 
0D0A53656374 
6F72204E6F74 
20466F756F64 
203A00 


27B1 
27B1 
27B1 
2802 


2862 
2863 
2865 
2867 
2869 


286A 
286B 
286C 


00 
0000 
0000 
0000 
40 


03 
00 
00 


Guide Avpendix E BIOS Listing 
er0 db cr,lf,°Null]. Error ??°,0 

erl equ er0 

er2 equ er( 

er3 equ er0 

er4 db cr,l€,°Clock Error :*,0 

er5 db cr,lf,*Late DMA :~,0 

er6 db cr,lf,°ID CRC Error :~,0 

er7 db cr,lf,“Nata CRC Error :°,0 
er8 db cr,l1lf,*Nrive Not Readv :~,0 
er9 db cr,lf,*Write Protect :°,0 

erA ab cr,1lf,°“T™rk 00 Not Found :”,0 
erB db cr,lf,°Write Fault :°~,0 

erc db cr,lf,“Sector Not Found :~,0 
erD equ er0 

erE equ er0 

erF equ er0 

nrdymsg equ er8 

rtry_cnt db 0 ;disk error retry counter 
last_com dw 0 ;address of last command string 
dma_adr dw 0 ;dma offset stored here 
dma_seg dw 0 sdma segment stored here 
sel _mask db 40h ;select mask, 40h or 80h 
: Various command strings for i8271 
io_com db 3 Length 

rd wr db 0 sread/write function code 
trk db 0 strack # 
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286D 


286E 
2871 


00 


022900 
012¢C 


02 

DFO2 
2105 
0020 
0020 


287C 


AB280000 
00000000 
C5289C 28 
64294529 


> AB280000 


00000000 
C5289C28 
93297429 


= 28AB 


01070D13 
19050B11 
1703090F 
1502080E 
141A060C 
1218040A 
1016 


OOl1F 
0010 


289C 
0O1F 
0010 
28AB 


28C5 


All Information Presented Her 


sect 


dab 


0 
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esector # 


hom_com Ab 2,29h,0 
rds_com db 1,2ch 


e 
0 


shome drive command 
eread status command 


System Memory Segment Table 


segtable db 2 


, 


dobase 


apeOd 


Apel 


dpb0 


x1t0 


dw 
dw 
dw 
dw 


equ 
dw 
dw 


tpa_s 
tpa_l 
2000h 
2000h 


2-2 segments 


eg 
en 


slst seg starts after RTOS 
sand extends to 08000 
esecond is 20000 - 


s3FFFF (128k) 
include singles.lib ;read in disk definitio 
NTSKS 2 
S sBase of Disk Param 
x1t0,9000h sTranslate Table 
~0000h,9000h sScratch Area 
Adirbuf ,dob0 eNir Buff, Parm Blo 


csv0,alv0 
x1t1,0000h 
0000h,0000h 
Airbuf ,dpbl 
csvl,alvl 


eCheck, Alloc Vecto 
eTranslate Table 
Scratch Area 

sDir Buff, Parm Blo 
eCheck, Alloc Vecto 


DISKNDEF 0,1,26,6,1024,243,64,64,2 


offset S eNisk Parameter RIO 
26 eSectors Per Track 
3 eRlock Shift 

7 «Block Mask 

0 eExtnt Mask 

242 eNisk Size - l 

63 eDirectory Max 

192 eAllocO 

0 eAllocl 

16 echeck Size 

2 -OfFSet 

offset §S sTranslate Table 

g lay Bm Bs Be Be 
25,5,1L1,17 

23,3,9,1L5 

21,2,8,14 

20,26,6,12 

~18,24,4,10 

16,22 

31 eAllocation Vector 
16 eCheck Vector Size 
NISKDEF 1,0 

dvb0 sEquivalent Paramet 
als0O eSame Allocation Ve 
css0 eSame Checksum Vect 
x1t0 eSame Translate Tab 
ENDEF 


Uninitialized Scratch Memory Follows: 


equ 


offset §$ 
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0000 


0000 
0002 


0004 


0380 
0382 


Appendix E BIOS Listing 


dirbuf rs 128 eDirectory Buffer 
alvO rs als0O eAlLloc Vector 
csv0 rs css0 eCheck Vector 
alvl rs alsl eAlloc Vector 
csvl rs cssl eCheck Vector 


enddat equ offset S$ eEnd of Scratch Are 
datsiz equ offset $-begdat ;Size of Scratch Ar 
db 0 sMarks End of Modul 


loc_stk rw 32 ;local stack for initialization 
stkbase equ offset §$ 


lastoff equ offset $ 
tpa_seg equ (lastoff+0400h+15) / 16 
tpa_len equ 0800h - tpa_seg 


ab 0 efill last address for GENCMD 
g RRR RRR RRR RRR RIK RAR REE RERERERE EERE 
x * 
3% Dummy Data Section * 
o * * 
8 


g KKK EERE RRR HERI RRR RRR RRR RHEE REE ER EEE EE 


dseg 0 sabsolute low memory 
org 0 >(interrupt vectors) 
int0O offset rw 1 
intO segment rw 1 
: pad to system call vector 
rw 2* (bdos_int-1l) 
bdos_ offset rw 1 
bdos_ segment rw 1 
END . 
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kkk KK KKK KKRKKKRKKKKKKRKKKKKKKKKRKKKKRKKRKKKRKRKRKRKRKRKRKKRRKRKRKEK 


* * 
* This is the listing of the skeletal CBIOS which * 
* you can use as the basis for a customized BIOS * 
* for non-standard hardware. The essential por- * 
* tions of the BIOS remain, with "rs" statements * 
* marking the routines to be inserted. * 
* *& 
* * 


KkKRKKKKKRKRKKKKKRKRKKKRKRKKKKRKRKRKKKKRKRKKKRKKRKKRKRKKRKRKRKRKRKRKRKRKK 


cHRKKEKKEKKKEKEKEKKHIKHEKKEKEKEEKREREKREKEKKKKRKREKRKEERKKKEKKEKK 


ex *& 
-* This Customized BIOS adapts CP/M-86 to * 
*-* the following hardware configuration * 
o* Processor: yi 
o* Brand: = 
eg Controller: . 
i * 
asl * 
al Programmer: * 
2 * Revisions : 9 
e * * 
eKKKEKEKKEKKEEKKEKREKKEEREKEER EERE KRERKEREREEKREREREREE 

FFFF true equ -l 

0000 false equ not true 

000D Cr equ Odh scarriage return 

OOOA lf equ Oah ;line feed 
g RK KK RIKKI EERE IRE REIKHEERRE REE KHER KKK 
o* * 
;* Loader bios is true if assembling the : 
;* LOADER BIOS, otherwise BIOS is for the * 
°* CPM.SYS file. | ~ 
ex * 
o RHEE KKK KKK EKER EEK EKER KR REE KRERE KEKE REE RERERE RE 

0000 loader bios | equ false 

OOEO bdos_int equ 224 ;reserved BNOS interrupt 

IF not loader bios 

| : | 

2500 bios_code equ 2500h 

0000 ccp_offset egu 0000h 

— 0B06 _ bdos_ofst equ OBO06h ;BDOS entry point 


| 
| 
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ENDIF  ;not loader_bios 

IF loader_bios 
| | 
bios_code equ 1200h ;start of LDBIOS 


Cccp | offset 


equ 0003h ;base of CPMLOADER 


bdos _ofst equ 0406h ;stripoed BNOS ates | 
; eee ee ew ewe we ew ewww ww wee we ww wen werner reese’ eee 
SNDIF ;loader_ bios 
cseg 
org ccvoffset 
Cccp: 
org bios code 


oI IR II IIR I IIR TOI TI IRR IR IIR ITER ER ERE 


o% 
a 


* 


¢* BIOS Jump Vector for Individual Routines * 


. 


* 


BEI IOC GOIIIIGI ICICI IOI ITO II 


2500 F93Cc00 imo INIT eFnter from BOOT ROM or LOADER 
2503 £97900 jmp WBOOT sArrive here from BNOS cal) 0 
2506 £98500 jmp CONST ereturn console keyboard status 
2509 E98D00 jmp CONIN ereturn console keyboard char 
250c E99A00 imp CONOUT ewrite char to console device 
250F E9A200 jmp LISTOUT ewrite character to list device 
2512 E9B500 jmp PUNCH ewrite character to vunch device 
2515 E9BDN0 jmp READER ereturn char from reader device 
2518 E9SF600 jmp HOME emove to trk 00 on-cur sel drive 
2518 E9D900 imp SELDSK sselect disk for next rd/write 
2518 £90101 jmp SETTRK eset track for next rd/write 
2521 E90301 jmp SETSEC eset sector for next rd/write 
2524 E90CO1 jmp SETDMA sset offset for user buff (DMA) 
2527 E91701 jmp READ sread a 128 byte sector 
252A E94701 jmo WRITE sewrite a 128 bhyte sector 
252N E98F00 jmp LISTST ereturn list status 
2530 E9FIO00 jmp SECTRAN sxlate logical- ->physical. sector 
2533 E90201 imp SETNMAB eset seg base for buff (NMA) 
2536 £90401 jmp GETSEGT ereturn offset of Mem Nesc Table 
2539 E9A400 jmo GETIOBF ereturn I/O map byte (IOBYTE) 
253C E9A500 jmp SETIOBF eset I/O map byte (IOBYTE) 

oT IR ITI RI IR TR IIR IR RIKER EKER EEE ER ES 

. * 

;* INIT Entry Point, Differs for LDBIOS and * 

. BIOS, according to “Loader _Bios" value 

i" 

SOI III III ITC III ITI TOR TOR III IIIA III REE 

INIT: sprint signon message and initialize hardwa 
253F 8CC8 mov ax,cCs ewe entered with a JMPF so 
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2541 


8ENDO mov sSSs,ax °CS: as the initial value o 
2543 8ED8 mov ds,ax “NS:, 
2545 8ECO Mov eS,ax sand FS: 
suse local stack during initialization 
2547 BC5928 mov sp,offset stkhase 
254A FC cld eset forward direction 
IF not loader bios 
¢ This is a BIOS for the CPM.SYS file. 
> Setup all interrupt vectors in low 
* memory to address trap 
254B 1E push ds ssave the DS register 
254C C606A72600 mov IOBYTE,0 sclear IOBYTE 
2551 B80000 mov ax,0 
2554 8ED8 mov ds,ax 
2556 8ECO mov eS,ax eset ES and NS to zero 
ssetup interrupt 0 to address trav routine 
2558 €70600008225 mov intO offset,offset int_tran 
255E 8C0E0200 mov int0 segment,Cs 
2562 BFO400 mov di,4 
2565 BEOOOO mov si,0 ethen propagate 
2568 BOFEOL mov cx,510 etrao vector to 
256B F3A5 rep movs ax,ax ;all 256 interrupts 
-BNOS offset to prover interrupt 
256D ©70680030608B mov bdos offset,bdos ofst 
2573 pop ds erestore the NS register 


1lF 


=e re. 


=e 


=e 


2574 BBB126 


Appendix F 


CBIOS Listing 


(additional CP/M-86 initialization) 


ENDIF snot loader _bios 


IF loader bios 


This is a BIOS 
push ds 

mov ax,0 

mov ds,ax 

sBWNOS interrupt offset 
mov bdos_offset,bdos_ofst 


for the LOANE 


R 


esave data segment 


spoint to segment zero 


mov bdos_segment,CS ;bdos interrupt segment 
(additional LOADFR initialization) 


pop ds erestore data 


ENDIF ;loader_ bios 


mov bx,offset signon 


segment 


2577 E86F00 call pmsg sprint signon message 
257A B100 * mov c1,0 edefault to dr A: on coldst 
257C E981DA sjump to cold start entry o 


ymp ccp 
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257F 


2582 
2583 
2585 
2587 
258A 
258D 


2585 
2598 


2599 
259C 
259E 
25A8 


25A9 
25B3 


25B4 
2 5BE 


25BF 
25C9 


25CA 
25D4 


25D5 
25DF 


25E0 


Appendix F CBIOS Listing 


E984NDA WBOOT: jmo ccpt+6 sdirect entrv to CCP at com 
IF not loader_bios 
int trap: 
FA cli eblock interrupts 
8CC8 mov ax,cs 
8ED8 mov ds,ax eget our data segment 
BBD126 mov bx,offset int_tro 
E85c00 call pmsg 
F4 hilt shardstop 
ENDIF snot loader bios 
ICI III IOI GIICI III ICICI ICI ITT II IIR IR IK 
o* * 
2 * CP/M Character T/O Interface Routines * 
«x * 
a 


wR RR RICH RRR TI IR RI IRI IIR KI IIHR RRR E EES 


CONST: sconsole status 
ts 10 e(Ffill-in) 
C3 ret 
CONIN: econsole input 
E8F2FF call CONST 
74FB jz CONIN ewait for RDA 
rs 10 e(fill-in) 
C3 ret 
CONOUT: econsole output 
rs 10 e(fill-in) 
C3 ret ethen return data 
LISTOUT : elist device output 
rs 10 (fill-in) 
C3 ret 
LISTST: epoll list status 
rs 10 (fill-in) 
C3 ret 
PUNCH: ewrite punch device 
rs 10 °(fill-in) 
C3 ret 
READER: 
rs 10 e(fill-in) 
C3 ret 
GETIOBF: | 
A0OA726 mov al,  IOBYTE 
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25E3 


25E4 
25E8 


2589 
25EB 
25ED 
25EF 
25F1 
25F4 
25F5 


C3 


880EA726 
C3 


8A07 
84C0 
7421 
8AC8 
E8B5FF 
43 
EBF2 


0002 


25F7 
25FB 
25FE 
2601 
2603 
2605 
2607 
2609 
260B 
260E 
2610 


2611 
2617 
2621 


2622 
2626 


2627 
262B 


262C 
2625 
2630 
2632 


880EA8 26 
BB0000 
80F902 
730D 
B500 
8BD9 
B104 
D3E3 
B9F126 
03n9 
C3 


C706A9260000 


C3 


890EA926 
C3 


890EAB26 
C3 


8BD9 
03DA 
8A1F 
C3 


ret 
SETIOBF: 


mov IOBYTE,cl 
ret 


pmsg: 
mov al, [BX] 
test al,al 
jz return 
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sset iobyte 
siobyte not imolemented 


sget next char from message 


eif zero return 


mov CL,AL 

cal.l CONOUT sprint it 

inc BX 

jmps pmsg enext character and loop 
g KKK KKK KIRK KKK ERK KKK ERR KEKE EERE REE REEKER 
e% | * 
ad Disk Input/Output Routines * 
xX * 


g RRR KKK HK KEKE RE KERR KER EERE RRR REERERERER 


SELDSK: . sselect disk given by register CL 
ndisks equ 2 snumber of disks (up to 16) 
mov disk,cl. ssave disk number 
mov bx,0000h sready for error return 
cmp cl,ndisks sn beyond max disks? 
jnb return sereturn if so 
mov ch,0 eAouble (n) 
mov bx,cx sbx =n 
mov cl,4 sready for *16 
shl bx,cl. en=n * 16 
mov cx,offset dpbase 
add bx,cx sdpbase + n * 16 
return: ret sbx = .dph 
HOME : smove selected disk to home position (Track 
mov trk,0 sset disk i/o to track zero 
rs 10 © (fill-in) 
ret 
SETTRK: ;set track address given by CX 
mov trk,CX 
ret 
SETSEC: ;set sector number given by cx 
mov sect,CX 
ret 
SECTRAN: ;translate sector CX using table at [DX] 
mov bx,cx 
add bx,dx eadd sector to tran table a 
mov bl, (bx! eget logica). sector 
ret 
SETDMA: ;set DMA offset given by CX 
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2633 890EAD26 


2637 


2638 
263C 


263D 
2640 


2641 
2673 


2674 
26A6 


C3. 


890EAF26 


C3 


BBE826 


C3 


C3 


26A7 


26A7 
26A8 
26A9 
26AB 
26AD 
26AF 


SETDMAB : 


GETSEGT: 


Appendix F CBIOS Listing 


mov dma_adr,CxX 


ret 


sset DMA seqment given by Cx 


mov dma_seqg,Cx 


ret 


sreturn address of physical memory table 


mov bx,offset seg_table 


ret 


eHHKKKKKKKKE KKK KE KKEKERKKEREREKREKEKEKEEKREKEEKKEKKKKESR 


All disk I/O parameters are setup: 


NISK is 
TRK is 
SECT is 


DMA_ADR is 
DMA SEG is 
READ reads the 


*& 
* 
disk number (SELDSK) * 
track number (SETTRK) * 
sector number (SETSEC) * 
the DMA offset (SETDMA) * 


the NMA segment (SETNDMAB) * 
selected sector to the NMA* 


address, and WRITF writes the data from * 
the DMA address to the selected sector * 


(return 00 iff successful, 


OL if perm err)* 
* 


eRKK KK KK KEKE KK KKK KEK KKK ERK KR KEK EKER KERKEKEERE 


READ: 
rs 50 
ret 

WRITE: 
rs 50 
ret 


efill-in 


e(fill—-in) 


eR KKK KKEREKKEEKREKRKEEKKEKKEEKEKEKEEKKEKREKKKS 


* 


Nata Areas * 


* 


eC KKKKKKKEKKEKKKEKEKREKRKEKKEKREKKEKKEKE EEE KKEERERRERKER 


data offset 


equ offset $ 


dseg 
org data_offset ;contiguous with co 
IOBYTE db 0 
disk Ab 0 sdisk number 
trk dw 0 strack number 
sect dw 0 ssector number 
dma adr dw 0 eDMA offset from DS 
dma seg dw 0 sNMA Base Segment 
If loader _bios 
Signon db cr,lf,cr,1lt 


All Information Presented Here is Proprietary to Digital Research 


142 


CP/M-86 System Guide 


26B1 
26B5 


=26F1 
=26F5 
=26F9 
=26FD 
=2701 


ODOAODOA 
53797374656D 
2047656566572 
617465642030 
302F30302F30 
30 

ODOAO0O 


ODOA 


Appendix F 


“cP/M-86 Version 


;loader_ bios 


not loader bios 


or, lf,cr, Ut 


CBIOS Listing 


1.0% ,cr,l1f£,0 


e naa wae we ewww Oe www www ww www ew www wwe ewww eee es esc ere 


oo oe oe ee oe ee ee ee ee ee ee ee we we ee ew www ww ewww an nee es eee 


e aaa aw eae ew Oe wee Owe ee eee eee eee ee eee ee ee 


496874657272 | 


757074205472 
61702048616C 
74 

ONOA 


02 

C602 
3A05 
0020 
0020 


26F1 


20270000 
00000000 
3A271127 
D927BA27 
20270000 
00000000 
3A271127 
0828E927 


e 
v 


db 


;not loader bios 


Cr gLet 


“Tnterrupt Trav Halt” 


cr,..t 


System Memory Seqment Table 


segtable db 2 


dpbase 
dpe0 


dw 
dw 
Aw 
aw 


tpa_s 
tpa_l 
2000h 
2000h 


22 segments 
eg elst seg 
en 


starts after BIOS 


sand extends to 08000 


ssecond is 20000 - 
e3FFFF (128k) 


include singles.lib ;read in disk definitio 


equ 
dw 


dw 


dpel 


apb0 


dw 
dw 


DISKS 2 

S 
x1t0,0000h 
0000h ,0000h 
dirbuf,dpb0 
csv0,alv0 
x1t1,0000h 
0000h,0000h 
dirbuf ,dobl 
csvl,alvl 
DISKDEF 0,1,26,6 
offset S$ 

26 


eBase of Nisk Param 
sTranslate Table 
eScratch Area 

eDir Buff, Parm Blo 
eCheck, Al.loc Vecto 
eTranslate Table 
Scratch Area 

sDir Buff, Parm Blo 
eCheck, Alloc Vecto 
,1024,243,64,64,2 
sNisk Parameter Blo 
eSectors Per Track 
eBlock Shift 

«Block Mask 

eExtnt Mask 

eDisk Size - l 
eDirectory Max 
eAllocO 

eAllocl 
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271C 1000 
271E 0200 
2720 
2720 01070D13 
2724 19050Bl11 
2728 1703090F 
272C 1502080F 
2730 141A060C 
2734 1218040A 
2738 1016 
OO1F 
0010 


2711 
OO1F 


0010 
2720 


2859 00 


0000 


0000 
0002 


0004 


0380 
0382 


dw 16 sCheck Size ——* 

dw 2 Offset 
x1t0 equ offset § ‘Translate Table 

db Lol ¢l3zl9 

db 2079p lag il 

Ab 23,3,9,15 

db 21,2,8,14 

db 20,26,6,12 

Ab 18,24,4,10 

db 16,22 
als0 equ 31 sAllocation Vector 
css0 equ 16 sCheck Vector Size 
H NISKDEF 1,0 
dobl equ Adobo ;Fquivalent Paramet 
alsl equ als0 -Same Allocation Ve 
cssl equ css0 sSame Checksum Vect 
xLtl equ x1t0 -Same Translate Tab 

ENDEF 


~e we VO 


Ininitialized Scratch Memory Follows: 


begdat equ offset §$ sStart of Scratch A 

Gdirbuf rs 128 sMNirectorv Ruffer 

alvO rs al.sO sAlloc Vector 

csv0 rs css0 eCheck Vector 

alvl rs alsl eAlloc Vector 

csvl rs cssl eCheck Vector 3 

enddat equ offset S eEnd of Scratch Are oo™ 

datsiz equ offset S-begqdat ;Size of Scratch Ar 
db 0 | eMarks End of Modul 


loc stk rw 32 ;local stack for initialization 
stkbase equ offset $ 


lastoff equ offset S$ 
tpa_seg equ (Lastoff+0400h+15) / 16 
tpa_len equ 0800h - tpa_segqg 


db 0 ;fill last address for GENCMN 
ekkRKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKRKRKKKRKRKKKKKRKK 
e* * 
rhe Dummy Nata Section , 
* * 
PITTI IIIT TEST T TTT TT TIT TE TTT TTT TTT Tite ee: 
dseg 0 sabsolute low memory 
org 0 s(interrupt vectors) 
int0O offset rw 1 
int0O segment rw 1 
: | pad to system call vector 
rw 2* (bdos_int-1) 
bdos_ offset rw 1 
bdos_ seqment rw 1 | 
END /—™ 
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A 


allocate absolute memory, 52 
allocate memory, 52 


B 


base vaae, l 
BIOS, 121 
bootstrav, 4 
bootstravo ROM, 81 


Cc 


CBIOS, 56, 137 
Close file, 34 
CmMr, 1, 15 
cold start loader, 1, 56, 81 
compact memorv model, 1l, 21 
compute file size, 45 
CONIN, 61 
CONOUT, 61 
console invout, 25 
console output, 25 
console status, 30 
CONST, 60 
converting 8080 proqrams 
to CP/M-86, 3, 17, 23 
cross develooment tools, 2 
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data block, 72, 74 
delete file, 36 

direct BIOS call, 47 
direct console I/0, 27 
directory entries, 71 


disk definition tables, 4, 67 


disk parameter block, 69 

disk parameter header, 62, 
67, 75 

DMA buffer, 14, 39, 60, 63 
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far call, ll, 14 
file control block, 30 
file structure, 1 
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GENCMD, 2, 3, 1.5, 17 
GENDEF, 2 


get address of disk parameter 


block, 41 
get allocation vector 
address, 39 
get DMA base, 48 
get I/O byte, 27 
get maximum memorv, 51 
get or set user code, 41 
get read/only vector, 40 
GETIONB, 65 
GETSEGR, 65 
group, 2 
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header record, 20 
COME, 61 
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TNIT , 4, 60 
Intel utilities, 17 
TOBYTE, 58 
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L-module format, 19 

LDCOPY, 2 

LIST,.61 

Tist output, 26 

LISTST, 63 

LMCMN, 19 

logical to physical sector 
translation, 64 
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make file, 37 

memory, 14 | 

memorv region table, 65 
memory regions, l 
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offset, 2 
oven file, 33 
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print string, 28 
program load, 53 
PUNCH, 61 

punch output, 26 
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random access, 95 

READ, 63 7 

read buffer, 29 

read random, 42 

read sequential, 36 

READER, 61 

reader inout, 26 

release all memory, 53 

release memory, 52 

rename, 38 

reserved software interrudt, 
: ee 

reset disk, 33 

reset drive, 46 

return current disk, 38 

return login vector, 38 

return version number, 30 
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search for first, 35 

search for next, 35 

sector blocking and 
deblocking, 87 

SECTRAN, 64 

seqment, 2 

segment group memorv 
requirements, 17 

segment register change, ll 

segment register 
initialization, 8 

SELDSK, 62 

select disk, 33 

set DMA address, 39 

set DMA base, 48 

set file attributes, 41 

set T/O byte, 28 

set random record, 46 

SETDMA, 63 

SETDMAB, 64 

SETIOB, 65 

SETSEC, 62 

SETTRK, 62 

small memory model, 10, 21 

system reset, 4, 7, 14, 25 
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translation vectors, 
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utility orogram overation, 
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WBOOT, 60 

WRITE, 63 

write protect disk, 
write random, 44 


write random with zero 


Fill, 47 


8080 memory model, 
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